Zend FR

Delprog a écrit:

Salut,

Arrête, s'il en trouve que 1000 il va penser que quelque chose ne vas pas

Pour le reste, c'est pas trop la bonne période pour que je me penche sur ce que tu as fais, mais je pense que je vais pouvoir me rendre plus dispo vers la fin du mois.

Dès que j'aurai regardé tu auras mon retour biensûr.


A+ benjamin.

Idem, je prends un peu de retard sur mon projet. D'ici un mois ça devrait aller mieux (enfin j'espère)

Bonsoir à tous

un petit update pour vous dire, si jamais ça en intéresse encore d'autres que moi-même , que j'ai pu avancé aujourd'hui sur CDM (outil support du projet de doc alternative).

J'ai fait un peu de nettoyage, et j'ai surtout ajouté le niveau de navigation qui manquait, à savoir la méthode.

Malheureusement, en arriver là mène également à un triste constat... le blocs PHPDoc ne sont que trop rarement renseignés correctement dans les sources !

Mais bon, ce n'est pas un drame, on fera sans

Prochaines étapes (majeures) : supporter plusieurs versions (ZF 1.0, 1.5, 1.6...) afin que l'on puisse accéder directement à la doc de la version que l'on utilise, et enfin, bien sûr, ajouter la possibilité de compléter le "squelette" que propose actuellement la base, reposant uniquement sur les sources...

J'aimerais vous solliciter sur ces points... je ne sais pas encore trop comment implémenter la possibilité d'intéragir pour ajouter des commentaires, exemples, mini-tutos ?, etc.

Pour le moment, j'imagine une sorte de wiki modéré (a posteriori sans doute), multi-lingue et multi-version. Ex: j'ajoute la description d'une méthode, je précise si ma description s'applique à telle ou telle, ou encore telles versions.

J'attends vos commentaires !

PS : pour mémoire, la version courante est visible sur http://cdm.gauthier.homelinux.net et le svn sur http://gauthier.homelinux.net/svn/cdm/

gauthier a écrit:

Bonsoir à tous

un petit update pour vous dire, si jamais ça en intéresse encore d'autres que moi-même , que j'ai pu avancé aujourd'hui sur CDM (outil support du projet de doc alternative).

J'ai fait un peu de nettoyage, et j'ai surtout ajouté le niveau de navigation qui manquait, à savoir la méthode.

Malheureusement, en arriver là mène également à un triste constat... le blocs PHPDoc ne sont que trop rarement renseignés correctement dans les sources !

Mais bon, ce n'est pas un drame, on fera sans

Prochaines étapes (majeures) : supporter plusieurs versions (ZF 1.0, 1.5, 1.6...) afin que l'on puisse accéder directement à la doc de la version que l'on utilise, et enfin, bien sûr, ajouter la possibilité de compléter le "squelette" que propose actuellement la base, reposant uniquement sur les sources...

J'aimerais vous solliciter sur ces points... je ne sais pas encore trop comment implémenter la possibilité d'intéragir pour ajouter des commentaires, exemples, mini-tutos ?, etc.

Pour le moment, j'imagine une sorte de wiki modéré (a posteriori sans doute), multi-lingue et multi-version. Ex: j'ajoute la description d'une méthode, je précise si ma description s'applique à telle ou telle, ou encore telles versions.

J'attends vos commentaires !

PS : pour mémoire, la version courante est visible sur http://cdm.gauthier.homelinux.net et le svn sur http://gauthier.homelinux.net/svn/cdm/

Ça avance

Pourquoi pas un wiki modéré, cela me semble intéressant, mais est-ce que ce type de solution permet également l'interaction via l'ajout de commentaires !?

As-tu besoin d'aide ?

Bonjour à tous,

je réactualise cette discussion, car je me demande si il y a du neuf ou pas.
Je ne veux surtout pas mettre la pression, je sais que nous avons tous notre lot de code à produire.

Ce qui existe pour le moment est sympa, mais pas tellement éloigné de ce que l'on peut obtenir avec un phpdoc.
(Pardon si je n'ai pas compris l'utilisation de ce qui a été mis en ligne)

J'espérais plutôt rassembler des questions concrètes et fréquentes pour lesquelles des réponse concrètes et complètes (c'est à dire prêtes à tourner) sont fournies.
Tant pis si dans les réponses il y a du code standard, il faut que l'on puisse récupérer une archive, on la décompresse dans le répertoire de son serveur de test, et mis à part un ou deux réglages pour les chemins, l'exemple tourne tout de suite et peut être étudié.

Avec comme règle absolue, l'exemple répond à la question et rien de plus. ça peut être tentant pour quelqu'un qui maitrise bien le sujet d'en faire un peu plus, en ce disant comme ça ils voient cette technique aussi et c'est cadeau.
En fait c'est le contraire, ce n'est pas un cadeau. Pour que ce soit facilement réutilisable il ne faut pas de "hors sujet".

Personnellement je m'étais proposé pour rassembler les demandes les plus fréquentes et pour tester les exemples, car rien n'est plus frustrant que de récupérer le code qui doit répondre à votre problème, et en fait nada, rien, ça ne tourne pas et on perd encore une ou deux journées pour faire tourner le code qui devait vous sortir la tête hors de l'eau...

Encore une chose, si par exemple on a des exemple type ajax, il faudrait une réponse avec les bibliothèques prises en compte par le ZF (Jquery et Dojo)...

Dernière modification par Jean-Marc Rigade (10-03-2009 12:04:11)

Bonjour,

je pense aussi que le point d'entrée pour la réponse à une question peut être une méthode ou une classe.
Avec malgré tout d'autres possibilités d'accès, car il peut arriver que le problème soit là mais que l'on soit tellement peu familier du domaine que l'on ne puisse pas aller directement sur la bonne classe.

Comment chercher la définition d'un mot dont on ne connait pas l'existence ?

Ceci dit, l'idée de pouvoir "raccrocher" des commentaires et des exemples à l'arborescence que tu as généré me plait bien.

En tout cas tu peux compter sur moi pour apporter ma pierre à l'édifice, dans la mesure de mes compétences. Et je suis conscient que toi aussi, le vrai luxe, c'est du temps libre...

c'est en effet comme ça que je le vois : rattacher les exemples directement aux composants qui les concernent mais permettre de les retrouver selon différents modes (arborescence, catégories, top consultations, tags, recherche...)

La FAQ d'Itanea est très bien.
Il suffirait de rattacher les élément à l'arborescence de la documentation alternative, et aussi de fournir un exemple complet et directement utilisable pour chaque élément de la faq.
Ce dernier point est fastidieux mais me semble important pour quelqu'un qui découvre le domaine.

Dernière modification par Jean-Marc Rigade (14-03-2009 11:55:46)

Cette discussion extrêmement longue et peut-être interminable qu’il est impossible de résumer d’une phrase mais qui tourne autour du fossé qui sépare la documentation ZF de sa mise en œuvre m’a amené à quelques réflexions que je vais me permettre (après hésitations) de vous soumettre.

Je crois que la documentation officielle est irremplaçable en tant que description extrêmement rigoureuse des
composants élémentaires de ZF, par contre elle s’avère assez limitée quand il s’agit de décrire finement comment utiliser au mieux certains  mécanismes fournis par ZF faisant intervenir plusieurs composants élémentaires et plus encore lorsqu’il s’agit d’indiquer comment réaliser simplement (minimum de code mais clair et évolutif) nos propres mécanismes avec en plus la contrainte de la performance.
Je pense que le projet de Gauthier bien qu’il soit certainement très intéressant  pour faire ressortir les liens
profonds  et pas toujours évidents entre les composants ZF n’épuise pas la question du gap  entre doc et dev.


Les forums, tutoriaux , blogs, livres et faq comblent en partie ce manque de dimension pratique de la doc qui n’est pas spécifique à ZF mais inhérent à toute doc technique :

    -Les forums du fait de leur caractère d’entraide sont des lieux ou l’interactivité est reine mais ou la moisson très riches des problèmes/solutions n’est pas capitalisée d’une manière organisée simplifiant la recherche . En particulier les questions de bonnes ou meilleures pratiques sont souvent présentes et donnent parfois lieu à des débats intéressants mais il n’en ressort pas ou rarement de mise en forme du type design pattern ou use case générique.

    -Les tutoriaux blogs, livres ainsi que morceaux de codes sur internet sont également très précieux mais malheureusement  comme pour les forums les problèmes/solutions on souffre en tant que lecteurs d’un certain éparpillement et  de l’absence de mise à jour.       

    -Les faqs sont rares,  un peu isolés et limités dans leur contenu .Je ne critique pas pour critiquer je suis conscient du gros travail effectué mais je note simplement la difficulté de ce genre de projet très voisin de celui qu’il faudrait entreprendre pour combler le gap doc dev  car son succès s’il est souhaité n’est pas pour autant garanti.

En gros ce que je verrai c’est un outil comportant un aspect orienté débats autour des meilleures pratiques (avec variantes et affinements possibles)  et un aspect  capitalisations sous forme condensé de ce qui en ressort .

Le contenu pourrait bien sur dépasser largement le périmètre ZF qui est centré sur un MVC étendu mais il me semble que déjà rien que sur ce sujet on a de quoi faire pour fixer des principes visant à des applis évolutives
et performantes .
Sans rentrer dans le détail mais simplement pour être un peu concret je pense par exemple à la construction
par blocs de page basé sur zend_layout avec utilisation préférentielle de helpers standards, partagés ou persos   ;ceci avec le souci de performance mais sans à priori exclure l’actionstack voire le helper action.
(cf [ur] http://www.rmauger.co.uk/2009/03/why-th … k-is-evil/[/url])


Il y a aussi (entre autres) mvc vu de zend_form ou l’utilisations des plugins et les action helpers pour remplir des fonctionnalités transversales ou génériques.

La structuration des sujets pourrait se traduire par un menu  probablement arborescent et éventuellement évolutif conduisant soit à un discussion soit à la consultation de ou des couples problème/solution retenus.

Réaliser un tel outil pose bcp de questions dont je n’ai que des bribes de solutions et comme il n’y a pas de faq sur la question il faudra bien que ceux qui veulent participer en discutent...

De plus à mon avis  un tel outil étant nécessairement collaboratif n'est envisageable que comme un prolongement de zf.fr.

Pardon d’être un peu long et sans doute péremptoire dans mes idées mais tant mieux si j’ai pu intéresser,  voire faire réagir, voire plus encore : donner envie de participer un jour à un projet de pont entre doc et dev tel que vaguement esquissé ici ou tout à fait différent; peu importe.

Bonjour à tous,

Je voulais vous féliciter de votre courage et de vos intentions envers ce projet. Je trouve cette idée fabuleuse. Je suis jeune débutant sur PHP / Zend / Framework (je suis en stage et j'ai appris PHP et Zend sur le tas.. Et je n'avais jamais utilisé de framework auparavant), et je vous avoue que sans ce forum, je m'y perds un peu (pour ne pas dire beaucoup).

Je ne peux que vous encourager (étant donné que j'ai des compétences limités pour le moment) et vous féliciter encore une fois !

Courage !

Cordialement,
Nikko