Un code bien écrit a-t-il besoin des commentaires ?
Quelle est la place des commentaires dans votre code ?
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 McconnellEnvoyé par P. GrahamEnvoyé par Steve McConnell
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 :
Ces commentaires sont bien, mais il est préférable de remplacer chaque commentaire avec un nom de méthode explicite ://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();
« Les commentaires doivent être généralement évités si le code peut dire ce qu’il fait. Les bons commentaires disent ce que le code ne peut pas exprimer, comme pourquoi une technique particulière a été favorisée ou les dangers de l’optimisation d’un bloc de code. La plupart des autres types de commentaires sont simplement du bruit et leur présence encombre le code », conclut Smith.Envoyé par Martin Fowler
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 ?
Partager