Cela fait pas loin de 20 ans que je programme, et j'avoue les commentaires sont pour moi essentielles, pas uniquement pour une autre personne, simplement pour moi, j'écris énormément de code dans une année et cela dans plusieurs langages simultanément. Bien souvent je dois intervenir dans des portions de codes que j'ai écrites il y a plusieurs mois, si je n'avais pas les commentaires pour m'aider je devrai redécoder ce que j'ai écrit, donc une perte de temps.
Les commentaires représentes qu'une partie de la qualité d'un code source, j'ajouterai des programmes de tests (automatique si possible), un bon découpage objet (une bonne conception donc), simplicité du code, sécurité du code (éviter aussi les attrapes nilgaut, en C/C++ cela ne manque pas), propreté des listings (indentation propre, entêtes de fonctions, de fichiers), la non redondance de code, et j'en oublie. Je me fixe ces règle là, étrangement mon code est robuste et facilement récupérable, malheureusement le code que je récupère d'autrui ne respecte bien souvent aucune de ces règles. J'ajouterai que certain on comme argument le manque de temps, je pense que c'est un faux problème, combien coute un programme mal écris, à mon avis énormément plus chère qu'un programme bien écris, mais c'est tellement plus facile de ne pas être rigoureux... Au passage l'ajout d'un commentaire au dessus d'une ligne de code ne prend que quelques secondes, à moins d'être un handicapé du clavier.