Le jour où j'ai découvert Doxygen, c'est en lisant une documentation générée avec.
Je trouvais la documentation rédigée de façon très sèche, très peu cordiale, sans touche d'humour, avec des exemples d'usage de fonctions répétitifs voire redondants (Quand on a compris la fonction FooDirect, FooReverse, BarDirect, est-ce nécessaire de documenter BarReverse avec exactement les mêmes noms de variable pour expliquer qu'elle effectue Bar de façon inversée?). Et certains points compliqués n'étaient vraiment pas détaillés, alors qu'il y avait au contraire trop de détails sur des fonctions triviales.
Du coup j'ai voulu en toucher un mot à l'auteur. Ça tombait bien, le PDF était signé, c'était marqué "Generated by Doxygen". Mais qui est Doxygen? Ah, d'accord. Salut Doxygen. :)
THIS IS JUST A PLACEHOLDER. YOU SHOULD NEVER SEE THIS STRING.
# Anecdote
Posté par Grunt . En réponse à la dépêche Nouvelle version pour Doxygen. Évalué à 10.
Le jour où j'ai découvert Doxygen, c'est en lisant une documentation générée avec.
Je trouvais la documentation rédigée de façon très sèche, très peu cordiale, sans touche d'humour, avec des exemples d'usage de fonctions répétitifs voire redondants (Quand on a compris la fonction FooDirect, FooReverse, BarDirect, est-ce nécessaire de documenter BarReverse avec exactement les mêmes noms de variable pour expliquer qu'elle effectue Bar de façon inversée?). Et certains points compliqués n'étaient vraiment pas détaillés, alors qu'il y avait au contraire trop de détails sur des fonctions triviales.
Du coup j'ai voulu en toucher un mot à l'auteur. Ça tombait bien, le PDF était signé, c'était marqué "Generated by Doxygen". Mais qui est Doxygen? Ah, d'accord. Salut Doxygen. :)
THIS IS JUST A PLACEHOLDER. YOU SHOULD NEVER SEE THIS STRING.