J'aime bien prendre exemple sur le code source de Dotclear. La manière dont sont documentés les fonctions PHP dans les sources de ses classes est vraiment formidable.
Mettre du HTML dans les commentaires du code source, tu trouves qu'il s'agit d'une manière formidable de documenter !
C'est sûr que le rendu de la documentation générée est classe. Mais pour le développeur, il code deux fois: une fois pour son application (en PHP pour dotclear), et une autre pour la documentation de son code source (en HTML).
[^] # Re: FreeDFD ?
Posté par _seb_ . En réponse au journal PHPXref pour les scripts Shell. Évalué à 1.
Mettre du HTML dans les commentaires du code source, tu trouves qu'il s'agit d'une manière formidable de documenter !
C'est sûr que le rendu de la documentation générée est classe. Mais pour le développeur, il code deux fois: une fois pour son application (en PHP pour dotclear), et une autre pour la documentation de son code source (en HTML).