27 juin 2020
_année_2020 _mois_juin citation code commentaire documentation intention programming
(2) Hillel sur Twitter : "The more docs and comments I write while hacking on code, the easier a time I have reorienting myself when I come back after a hiatus. Self-documenting code is nice but doesn’t capture the path-dependence, thought process, and context the way comments do." / Twitter
Alors ça c’est très vrai : les commentaires ne sont pas forcément là pour paraphraser le code, mais plutôt pour donner l’intention du développeur quand il a écrit le code.