Hier, le Framablog a publié un billet intitulé Montre-moi tes commentaires et je te dirai si tu es un bon développeur, traduit d'un article en anglais d'Esther Schindler intitulé If the comments are ugly, the code is ugly (en français : si les commentaires sont laids, le code est laid).
D'aucuns trouveront osée l'idée qu'un code de qualité est indissociable d'un commentaire soigné. En tout cas, la lecture de ce billet du Framablog m'a rappelé ce que dit un ami développeur PHP (et qui figure dans sa signature lorsqu'il poste sur certains forums techniques
) : Codez en pensant que celui qui maintiendra votre code est un psychopathe qui connaît votre adresse
.

Commentaires
Un code commenté, c'est plus pratique pour essayer de comprendre ce qu'a voulu faire le développeur.
Car rien de plus rageant de voir un code sans commentaire et ne pas savoir ce que fait telle fonction.