John Perr a écrit :
> Dans la dernière révision de l'arborescence de développement, il y a une
> tentative de création de documentation pour avis:
>
> -Documentation développeur:
> Elle utilise phpdocumentor utilisé par exemple par PEAR et est générée à
> partir de "docblocs" écrit dans le code.
> http://www.phpdoc.org/
> Vous pouvez voir le résultats dans le répertoire docs/index.html. C'est
> encore loin d'être complet mais si cela plaît à cette liste alors on
> peut l'adopter. Dans ce cas, il y a quelques règles d'écriture à
> respecter et le plus simple serait probablement d'adopter celles de pear
> par exemple:
> http://pear.php.net/manual/fr/standards.php
>
> -Manuel utilisateur
> La c'est un plagia exhaustif du site de tuxfamilly/galette avec quelques
> petits ajouts concernant les préférences. Le résultat html est visible
> dans docs/manual/manual.html. On peut générer aussi du pdf à partir des
> sources en xml/docbook mais ça reste à faire, et il faut installer Fop
> sur la machine qui génère le manuel. Pour fabriquer du html il faut
> xsltproc.
> Il est théoriquement possible de fabriquer des pages pour un site web
> mais dans le cas de tuxfamily, il faudrait écrire ou (modifier beaucoup)
> un xsl qui produise un format compatible du wiki tuxfamily. Donc forget
> it...
> phpdocumentor à la possibilité d'intégrer la doc annexe  mais comme ce
> n'était pas très convaincant, la création du manuel est restée
> indépendante de la doc développeur.
>   

Salut,

Je n'ai pas encore eu le temps ( le courage? shame on me ;o) ) de
regarder cela en profondeur, cependant j'ai une petite remarque : le
"cartouche" de licence GPL a été supprimé dans les fichiers modifiés, il
vaudrait mieux le laisser je pense, c'est ce que j'en comprend à la
lecture de la page : http://www.gnu.org/licenses/gpl-howto.html.

Ce n'est pas incompatible à mon sens avec la mise en place du système de
documentation...

Pour les conventions de codage, il me semble en effet utile et
intéressant de reprendre celles de PEAR, pour ma part.

Bon dimanche,
Johan

Attachment: signature.asc
Description: OpenPGP digital signature

_______________________________________________
Galette-devel mailing list
Galette-devel@gna.org
https://mail.gna.org/listinfo/galette-devel

Répondre à