Doxygen construit une référence qui est assez indigeste, mais il est possible d'obtenir quelque chose de plus facile à lire (et plus utile). Je prends pour exemple la documentation d'ALSA (qu'est-ce que je fais !) qui présente les concepts de l'API, permet de naviguer vers la référence des fonctions et de voir des exemples. Doxygen donne donc les moyens de réaliser une documentation propre et agréable ; ensuite c'est aux développeurs d'écrire un peu en langage naturel pour obtenir une documentation utile.
[^] # Re: Anecdote
Posté par nigaiden . En réponse à la dépêche Nouvelle version pour Doxygen. Évalué à 10.
Doxygen construit une référence qui est assez indigeste, mais il est possible d'obtenir quelque chose de plus facile à lire (et plus utile). Je prends pour exemple la documentation d'ALSA (qu'est-ce que je fais !) qui présente les concepts de l'API, permet de naviguer vers la référence des fonctions et de voir des exemples. Doxygen donne donc les moyens de réaliser une documentation propre et agréable ; ensuite c'est aux développeurs d'écrire un peu en langage naturel pour obtenir une documentation utile.