Création de docs logiciel

Eléphant du PHP | 450 Messages

30 janv. 2007, 13:48

Bonjour ,
Au cours d'un stage , j'ai developper un "logiciel" en php mysql et css.
Et aujourd'huit je suis censé en faire la documentation, mais le probleme est que je ne sait pas quoi y mettre et que je trouve pas de docs a ce sujet.

Si vous savez a quoi correspond une documentation de logiciel je serais bien intéréssé.

Merci d'avance :)
Alone in the dark , I smile :D

HD
Mammouth du PHP | 1181 Messages

30 janv. 2007, 13:57

une fois que tu sais ce qu'est ce que la documentation d'un logiciel, ceci te sera peut être utile :
Comparatif des générateurs de documentation PHP :
http://cyberzoide.developpez.com/php4/phpdoc/
"Si Dieu descendait sur la Terre, tous les peuples se mettraient a genoux, excepte les Français qui diraient : " Ah ! Vous êtes la ! C'est pas trop tôt ! On va pouvoir discuter un peu !" [Michel Balfour]

Avatar du membre
Administrateur PHPfrance
Administrateur PHPfrance | 13231 Messages

30 janv. 2007, 15:59

La documentation d'un logiciel ne se limite pas à documenter le code.

Pour moi, la base d'un logiciel bien documenté, c'est un manuel utilisateur permettant la prise en main du logiciel par tous.
Ensuite, il y a un document d'installation/configuration/déploiement
Enfin, il y a la documentation du code.

Mais, toujours selon moi, quand tu as bien commenté ton code et si tu as eu la bonne idée de suivre la syntaxe PHPDoc, cette dernière étape n'est pas la plus longue ni la plus compliquée ;)
Connaître son ignorance est la meilleure part de la connaissance
Pour un code lisible : n'hésitez pas à sauter des lignes et indenter

twitter - site perso - Github - Zend Certified Engineer

Mammouth du PHP | 592 Messages

30 janv. 2007, 17:06

salut,

ça dépend de ce que tu entend par documentation et à qui elle est destinée.

Par exemple pour un administrateur, tu n'aura qu' présenter les grandes parties. :P

Par contre pour un utilisateur (souvent les pires de tous), il faut expliquer la fonction de chaque bouton. :(