Un commentaire, ca doit expliquer la raison d'etre d'un code illogique au 1er abordS (2 abords: metier et technique).
La plus grosse partie des "doc" doxygen & co est effectivement auto-generee, et donc inutile.souvent, ca decrit les parametres, qui ont deja un nom parlant.
Perso, je prefere decrire l'intention du bloc de code, ses pre-conditions et post-conditions, et si possible le faire en code, a coups d'assert() ou autres verifiables par le compilo.
Les intentions des parametres sont tres souvent dans leur nom apres tout.§
Pour les langages qui peuvent pas, c'est simple: je ne les utilise pas. Je considere que l'absence d'analyseur statique gratuit, libre et de qualite decente est un element de preuve qu'un langage est a eviter.
C et Cpp ont ca, java en a, pascal probablement.
# je trouve les commentaires peu utiles. Par contrec la doc est trop absente!
Posté par freem . En réponse au lien Mort aux commentaires inutiles ! Écrivez des commentaires pertinents !. Évalué à 3.
Un commentaire, ca doit expliquer la raison d'etre d'un code illogique au 1er abordS (2 abords: metier et technique).
La plus grosse partie des "doc" doxygen & co est effectivement auto-generee, et donc inutile.souvent, ca decrit les parametres, qui ont deja un nom parlant.
Perso, je prefere decrire l'intention du bloc de code, ses pre-conditions et post-conditions, et si possible le faire en code, a coups d'assert() ou autres verifiables par le compilo.
Les intentions des parametres sont tres souvent dans leur nom apres tout.§
Pour les langages qui peuvent pas, c'est simple: je ne les utilise pas. Je considere que l'absence d'analyseur statique gratuit, libre et de qualite decente est un element de preuve qu'un langage est a eviter.
C et Cpp ont ca, java en a, pascal probablement.