Pour être honnête, je document aussi les pré-conditions, post-conditions et invariants qui ne sont pas évidents et/ou des fonctions publiques. Histoire de pas aller fouiner dans le code lui-même à chaque fois...
Mais j'appelle pas trop ça du commentaire, plutôt de la doc, même si c'est fait via des commentaires doxygen.
[^] # Re: Faut voir...
Posté par freem . En réponse au sondage Les commentaires et vous ?. Évalué à 3.
Pour être honnête, je document aussi les pré-conditions, post-conditions et invariants qui ne sont pas évidents et/ou des fonctions publiques. Histoire de pas aller fouiner dans le code lui-même à chaque fois...
Mais j'appelle pas trop ça du commentaire, plutôt de la doc, même si c'est fait via des commentaires doxygen.