10 septembre 2024
'Maintenant disponible! C'est une version légère alors que j'en apprends davantage sur le formatage d'un livre au bon aspect. Vous pouvez voir certaines des différences entre v2 et v3 ici.'
Le code est écrit dans un langage machine structuré, les commentaires sont écrits dans un langage humain expressif. Le bit "langage humain" rend les commentaires plus expressifs et communicatifs que le code. Le code a une quantité limitée de quelque chose comme le langage humain contenu dans les identifiants. "Commenter le pourquoi, pas le quoi" signifie pousser autant d'informations que possible dans les identifiants. Tous les "quoi" ne peuvent pas être intégrés de cette manière, mais beaucoup le peuvent.
Ces dernières années, je vois de plus en plus de personnes soutenir que les pourquoi n'ont pas leur place dans les commentaires non plus, qu'ils peuvent être intégrés dans LongFunctionNames ou les noms des cas de test. Virtuellement tous les codebases "auto-documentés" ajoutent de la documentation par l'ajout d'identifiants.1
Alors, qu'est-ce qui se trouve dans le domaine de l'expression humaine qui ne peut pas être représenté avec plus de code ?