You are not logged in linkOpaque.gif Log in linkOpaque.gif Join
You are here: Home » Members » babar's Home » Cri du coeur d'un développeur...

Une communauté active ?
Trouvez vous facilement les réponses à vos questions sur ZOPE, PLONE ou CPS (ou autres interfaces)
oui trés facilement
ca va
moyennement il faut pas mal chercher
non c'est assez dur
quasiment jamais

[ Results | Polls ]
Votes: 518
About
Created by
babar
Document Post dans le forum
Last modified
07/11/03
State
published

Cri du coeur d'un développeur...


Pour participer à cette discussion, cliquez ici pour vous inscrire.

Auteur Discussion
babar
Cri du coeur d'un développeur...
Existe-il une documentation claire et précise sur les objets élémentaires installés avec la distribution de base de Zope ?

Développeur internet, je découvre Zope depuis quelques jours.
Je l'ai installé sur le serveur de dév de ma boîte.
J'ai lu le Zope Book, fait joujou avec le CMF.
J'ai écrit quelques ZPT genre "Coucou voici ma première page", et un petit formulaire avec un traitement bêbête en python.
J'ai monté des pages statiques avec des macros en metal.
Très bien.
Et maintenant ?
Savez-vous où je pourrais trouver une description claire des objets installés avec la distribution de base de Zope ?
Car quand je vois des choses du genre : manage_addProduct['OFSP']
... je suis un peu perplexe. D'où vient ce OFSP ?
Un produit peut-être, mais encore ?
Quand j'ai appris Java, on m'a expliqué quelques packages de base et leurs classes. Lorsque j'ai eu besoin de faire des choses plus compliquées, je me suis alors penché sur de nouvelles classes, mais l'apprentissage fut progressif.
Pareil avec .NET (oui, j'avoue, g honte :-) : j'ai d'abord appris le comportement des classes élémentaires du framework.

Mais la pédagogie des sites sur Zope consiste à montrer le CMF, à montrer la syntaxe des ZPT et des DTML, et elle ne s'intéresse pas beaucoup aux objets de base, et à la façon dont on les manipule.
C'est pourtant (une fois dépassé le stade de la syntaxe des templates) ce qui va intéresser en premier lieu le développeur !

D'accord, il y a l'API Reference... Mais qu'est-ce qu'elle est mal présentée ! Qu'est-ce qu'elle est indigeste ! Jamais vu un truc aussi linéaire, plat, et avec si peu de relief. Les exemples sont chétifs, et jamais remis dans un contexte d'utilisation.

A mon avis, si l'on veut intéresser plus de développeurs à Zope, c'est pourtant sur cette API qu'il faut mettre l'éclairage, et en faire ressortir les points essentiels dans une perspective "classique" de dév de sites dynamiques (création-modification d'objets simples, traitement des formulaires HTML, stratégies d'organisation des pages dynamiques sous Zope, etc.)
Mon patron a besoin que je lui montre des choses simples et rapides à faire sous Zope, pour se décider à entrer dans la danse...
Or, ça fait cinq jours que je suis dessus, j'ai lu plein de choses intéressantes sur ZPT et Python, mais je suis à peine capable de monter une page de gestion simple, genre une page de liste de fiches, et une page d'ajout-modification de fiche.

Heureusement qu'il y avait un exemple de petit Guestbook inclus dans ma distribution de Zope, sans ça, j'aurais même pas su comment démarrer !

J'ai bien les cahiers du programmeur sous la main ("mon premier site collaboratif avec zope")... mais seul le dernier tiers du bouquin commence à évoquer les aspects importants, et puis, bon,  j'espérais un peu plus qu'un traité de personnalisation du CMF !

Je plaide pour une meilleure pédagogie de Zope à destination des développeurs !!

:))

baptiste

Posté le 07/11/2003 @ 14:00

fabrice1970
absence de documentation

je suis dans le même cas que toi, après 3 ans d'étude en informatique durant lesquelles j'ai eu l'occasion d'approfondir java avec une documentation précise des fonctionnalités du système, je me retrouve dans la M... avec Zope qui est un outil fabuleux pour des applications simples en dtml mais dont la documentation des fonctions inhérentes au système est imbuvable. Il faut toujours prendre des petits morceaux de code dans des applications déjà faites pour évoluer, c'est vraiment chi... Si je trouve une source fabuleuse de documentation de l'API, je te le signalerai

Posté le 08/11/2003 @ 11:14

gillou

Installe le DocFinderEverywhere (chercher dans zope.org). Celui-ci ajoute un onglet "doc" à tous les objets, montrant l'API de l'objet en question. Bien entendu, ça ne vaut pas une vraie doc d'API (style javadoc).

Cherche Zpydoc et Zepydoc dans zope.org qui sont capables de fournir des docs à la Javadoc sur l'API de Zope.

Il est vrai toutefois que ces 3 produits, s'appuyant sur les docstrings python mettent en valeur l'aspect "mikado" de certains packages de Zope.

Par exemple, il faut avoir le tube d'aspirine à portée de la main quand on explore pour la première fois la doc d'API de l'acquisition, ou de packages comme AccessControl (la sécurité) ou ZTUtils (seul le Batch est documenté, le reste... dém...ez-vous!).

Il y a des sources précieuses de renseignement dans le Zope developer guide également.

Posté le 08/11/2003 @ 19:35

babar

merci à tous les deux !

Posté le 12/11/2003 @ 11:03

szwr
Petite précision

DocFinderEverywhere a été renommé en DocFinderTab ici : DocFinderTab

Posté le 16/02/2005 @ 14:38

Recherche
Log in
Syndication
« January 2009 »
Su Mo Tu We Th Fr Sa
        1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 31