Les commentaires dans le code

« [comments] It is a “back channel” of communication between the author of the program and all of its future readers to convey information about the program. »
Prologue de How to Design Programs.

Les commentaires ne sont pas là pour passer des tests de bonnes conduites et souffler de désespoir sur la redondance avec la définition de votre fonction (vous êtes dans l’erreur, C3 du Clean Code), ils sont là pour communiquer avec vous dans le futur ou encore plus important avec un autre codeur dans le futur, ils sont là pour faire gagner du temps … mais dans quelques mois.

 

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *