Personnellement je retiens la règle suivante : le commentaire ne sert qu’à :

- documenter une fonction (entête qui explique le rôle de la fonction, ses paramètres typés, ce qu’elle retourne, les exceptions possibles etc… en syntaxe doxygen compliant)

- expliquer *pourquoi* on fait quelque chose, ou expliquer brièvement un algorithme complexe (chi*nt) à la relecture.

Très bon billet, je serais en faveur de commentaires limité.
Parce que le prof disais aussi, de toujours de donner des noms explicites aux variables.

Je place que très rarement des commentaires dans mon code.
Je peut en mettre si je sais qu’il vas servir à des fin ‘éducatif’ ou malheureusement rendre encore plus inutile du code déjà inutile.

Je viens de découvrir ce blog et je voulais vous féliciter pour la pertinence de son contenu.

Je suis à 300% d’accord avec vous sur l’utilisation des commentaires.

Merci mon prof de TDD.

Ca fait 10 ans que je bosse, je sais toujours pas quoi penser de cette phrase : des fois je la trouve vraiment au top, et des fois je me dis «  non, c’est trop naïf, t’auras toujours besoin de commenter un truc  ».