“Un code sans commentaire est un mauvais code,
un bon code n’a pas besoin de commentaire…”

Si je me souviens bien ça doit venir de The Pragmatic Programmer, une lecture hautement recommendable.

Je suis tombé sur ce billet qui illustre assez bien l’idée, plutôt que de mettre de tonne de commentaires dans le code pour respecter “les normes”, mieux vaux passer un peu de temps à refactorer son code pour qu’il n’y ait plus besoin de commentaire. Il est beaucoup plus dur (mais plus efficace aussi) de trouver les 3 mots qui vont former un nom de méthode explicite que de mettre 3 lignes de commentaires au dessus de doStuff().

Attention, je n’ai pas dis qu’il ne fallait pas de commentaires dans le code, mais juste la où il y en a vraiment besoin.