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. 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. 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.) 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
|

Log in
Forgot your password?