Je parlais avec un collègue aujourd'hui. Nous travaillons sur du code pour deux projets différents. Dans mon cas, je suis la seule personne à travailler sur mon code; dans son cas, plusieurs personnes travaillent sur la même base de code, y compris des étudiants coopératifs qui vont et viennent assez régulièrement (entre tous les 8 à 12 mois). Elle a dit qu'elle était libérale avec ses commentaires, les mettant partout. Son raisonnement est que cela l'aide à se rappeler où se trouvent les choses et ce qu'elles font, car une grande partie du code n'a pas été écrit par elle et pourrait être modifiée par quelqu'un d'autre qu'elle. Pendant ce temps, j'essaie de minimiser les commentaires dans mon code, en les mettant uniquement dans des endroits avec une solution de contournement ou un bug non évident. Cependant, j'ai une meilleure compréhension globale de mon code et un contrôle plus direct sur celui-ci.
Mon opinion à cet égard devrait être minimale et le code devrait raconter la majeure partie de l'histoire, mais son raisonnement est également logique. Y a-t-il des défauts dans son raisonnement? Il peut encombrer le code, mais il pourrait finalement être très utile s'il y a beaucoup de gens qui y travaillent à court ou moyen terme.