Bonjour,
Ce serrait pas mal de faire un petit tuto sur phpdocumentor, doxigen, etc. !

7 réponses


Guique
Réponse acceptée

Et pourquoi ne pas commencer ce tutoriel par un présentation des bonnes pratiques de documentation? :)
Très bonne idée en tout cas.
Il est important d'apprendre dès le départ à bien commenter son code.

C'est une bonne idée. Encore faudrait il que les devs commentent leur code dans un premier temps :).

Ahah oui ! Mais dans un tuto c'est moins important que lors d'un projet :p

@prbaron, c'est vrai, j'ai travaillé dans plusieurs entreprises varié et de différentes tailles, hélas tous ceux chez qui j'ai travaillé n'utilisaient pas les docComment sauf lorsque j'ai travaillé avec des amerlock. C'est quand même dommage, perso je les mets car dans les ide sur un autocomplete ça aide pas mal je trouve.

Sinon, pour la doc, Grafikart à fait un tutoriel sur le Markdown utilisé sur Github par exemple