En programmation, les commentaires sont des portions du code source ignorées par le compilateur ou l’interpréteur, car ils ne sont pas nécessaires à l’exécution du programme.Dès les premiers cours de programmation, il est conseillé de « toujours et bien » commenter son code. Les commentaires permettent de facilement comprendre le code et de pouvoir le modifier rapidement.
Je suis tombé sur un excellent billet de blog de Steve Smith, un développeur .NET, qui estime que le code devrait être écrit de telle manière que sa simplicité élimine la nécessité de la plupart des commentaires. Son article est étoffé de plusieurs citations intéressantes sur les commentaires que je vais reprendre quelques-uns.
Envoyé par Steve Mcconnell
Si le code est tellement compliqué que cela doit être expliqué, il est presque toujours préférable d’améliorer le code que d’ajouter des commentaires
Envoyé par P. Graham
La meilleure façon de faire des programmes faciles à lire n’est pas de les farcir de commentaires [...] Un bon langage de programmation devrait mieux expliquer un logiciel que l’anglais
Envoyé par Steve McConnell
Un bon code est sa propre documentation. Lorsque vous êtes sur le point d’ajouter un commentaire, demandez-vous : « Comment puis-je améliorer le code de sorte que les commentaires ne soient plus nécessaires ?» Améliorez le code, puis documentez pour le rendre encore plus clair
Pour Smith, la meilleure façon d’y parvenir est de nommer les variables et les classes de manière cohérente et explicite. Ecrire de petites méthodes bien nommées. Par exemple, les commentaires :
//Extraire les données de l’ancien système
//Transformer les données
//Charger les données dans le nouveau système
Extract();
Transform();
Load();
Envoyé par Martin Fowler
Lorsque vous sentez le besoin d'écrire un commentaire, essayez d'abord de modifier le code de sorte que tout commentaire devient superflu
Source : Billet de blog Steve Smith
Et vous ?
Que pensez-vous de la conclusion de Steve Smith ? Un code de bonne qualité doit-il systématiquement avoir des commentaires ? Quelle place les commentaires occupent dans votre code ? Quels sont vos conseils pour bien commenter son code ou éviter les commentaires superflus ? 
Si au moins on diminuait le temps d'exécution du code, mais même pas... Par contre on risque de compliquer la lecture du code ! Je préfère ligne 2 lignes m'expliquant à quoi sert une fonction que me taper les 50 du corps de la fonction ! 
