Chapitre 8. Commentaires
Cet ouvrage a été traduit à l'aide de l'IA. Tes réactions et tes commentaires sont les bienvenus : translation-feedback@oreilly.com
Le bon usage des commentaires est de compenser notre incapacité à nous exprimer en code.
Robert C. Martin, Clean Code : A Handbook of Agile Software Craftsmanship (Manuel d'expertise logicielle agile).
8.0 Introduction
À l'époque de la programmation en langage d'assemblage, la distance entre ce que tu avais l'intention de dire en tant que programmeur et la façon dont l'ordinateur fonctionnait était énorme. Toutes les quelques lignes (parfois à chaque ligne), tu avais besoin d'une petite histoire pour t'aider à comprendre ce que signifiaient les quelques instructions suivantes. Aujourd'hui, les commentaires sont souvent une incapacité à choisir de bons noms. Tu n'en auras besoin que pour décrire des décisions de conception très importantes. Ce sont des codes morts puisqu'ils ne se compilent pas et ne s'exécutent pas. Les commentaires ont tendance à diverger du code qu'ils décrivaient auparavant. Ils deviennent des îlots flottants d'inutilité et de mauvaise direction dans le code. Un code propre n'a pratiquement pas besoin de commentaires. Tu trouveras quelques critères sur la façon de les utiliser dans les recettes suivantes.
Langage d'assemblage
Lelangage d'assemblage est un langage de programmation de bas niveau permettant d'écrire des programmes logiciels pour des architectures informatiques spécifiques. C'est un code ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access