Je considère, comme Michel, qu'il faut pouvoir justifier chaque choix technique dans le code, en descendant au niveau de détail de la ligne de code. Le problème, c'est que quand un code est bien écrit, il peut y avoir plusieurs justifications (se renforçant mutuellement) pour certaines lignes de code.
SI je devais documenter absolument tous les éléments que je prends en compte quand je code, ben je coderais pas beaucoup :D
D'après moi, ce qu'il faut documenter dans le code, c'est plutôt l'intention qui le guide.
[^] # Re: goto ?
Posté par gaaaaaAab . En réponse à la dépêche Sortie de GCC 4.5. Évalué à 4.
Je considère, comme Michel, qu'il faut pouvoir justifier chaque choix technique dans le code, en descendant au niveau de détail de la ligne de code. Le problème, c'est que quand un code est bien écrit, il peut y avoir plusieurs justifications (se renforçant mutuellement) pour certaines lignes de code.
SI je devais documenter absolument tous les éléments que je prends en compte quand je code, ben je coderais pas beaucoup :D
D'après moi, ce qu'il faut documenter dans le code, c'est plutôt l'intention qui le guide.