Je confirme que le livre "the clean Code" de Robert C. Martin est une petite perle. Il détaille les différents "types" de commentaires et explique pourquoi ils ne servent pas.
Les trucs du style :
int i=0; // indice de mon tableau d'articles
devrait s'écrire :
int indice_tableau_articles=0;
Les commentaires pour mettre de côté du code que l'on n'a plus besoin "pour le moment" mais que l'on veut garder sous le coude peuvent rentrer dans le gestionnaire de version de source (git, svn...)
Certains commentaires peuvent aussi rentrer en "commentaire des commits" à la place de l'intérieur du code.
Bref, il y a sans doute des cas de figure où le commentaire est utile, mais beaucoup de cas où ils ne sont là que pour contourner une autre faiblesse du code.
[^] # Re: Code auto-documente
Posté par axel584 . En réponse au sondage Les commentaires et vous ?. Évalué à 1.
Je confirme que le livre "the clean Code" de Robert C. Martin est une petite perle. Il détaille les différents "types" de commentaires et explique pourquoi ils ne servent pas.
Les trucs du style :
devrait s'écrire :
Les commentaires pour mettre de côté du code que l'on n'a plus besoin "pour le moment" mais que l'on veut garder sous le coude peuvent rentrer dans le gestionnaire de version de source (git, svn...)
Certains commentaires peuvent aussi rentrer en "commentaire des commits" à la place de l'intérieur du code.
Bref, il y a sans doute des cas de figure où le commentaire est utile, mais beaucoup de cas où ils ne sont là que pour contourner une autre faiblesse du code.