Quel que soit le langage, j'ai toujours incorporé des commentaires à mes codes sources. Une preview de Visual Studio .net, il y a quelques années, m'a suggéré l'emploi de tags XML. L'intérêt de cette méthode est la capacité, du coup, a générer une documentation au moyen de quelques scripts. Désormais, je le fais non seulement pour le PHP mais aussi le javascript, le C++...
De quoi Autodoc est-il capable ? En voici un petit exemple (Scripts.chm est indisponible), au format CHM.
Convaincu ?