on va sagement mettre un gros commentaire Doxygen au début de chaque fonction et bêtement répéter ce que fait le code dedans. ça n'a aucun intérêt.
L’intérêt est de comprendre à quoi est censée servir la fonction en question, en lisant juste le code je ne sais ce que fait la fonction effectivement, ça peut simplifier des tâches de debug.
De plus ça aide les nouveaux dev à entrer plus doucement dans un gros projet.
Avoir une documentation qui prend de la hauteur et décrit l'architecture sans trop entrer dans les détails, ça n'est pas le but de doxygen.
[^] # Re: la spec, c'est le code
Posté par Lutin . En réponse à la dépêche Développement très rapide d’applications libres : Extended Man/XML Frames. Évalué à 3.
L’intérêt est de comprendre à quoi est censée servir la fonction en question, en lisant juste le code je ne sais ce que fait la fonction effectivement, ça peut simplifier des tâches de debug.
De plus ça aide les nouveaux dev à entrer plus doucement dans un gros projet.
Avoir une documentation qui prend de la hauteur et décrit l'architecture sans trop entrer dans les détails, ça n'est pas le but de doxygen.