Re: Commenter l'intention

Je suis globalement d'accord avec ce que tu écris, et notamment les exemples qui sont très bons, sauf sur ce point :

Cependant les commentaires tu ne peux généralement les décider et les écrire correctement qu'une fois que le code existe.
Je trouve que c'est d'autant plus vrai qu'on maîtrise moins ce que l'on fait. Généralement, plus on maîtrise le sujet traité et les technologies, moins on a besoin d'attendre d'écrire le code pour écrire les commentaires, parce qu'on s'est déjà posé les questions avant d'écrire le code. Quand on découvre des choses en codant (api extérieure au comportement mal maîtrisé, technologies pas assez bien connues…), on est obligé d'écrire des commentaires en codant.
Après, c'est aussi ma manière de coder et écrire des commentaires, elle me convient très bien :) et le résultat convient à mes collègues quand ils reprennent mon code, c'est l'essentiel.
On peut aussi préférer écrire code et commentaire en même temps, mais je trouve que ça freine la pensée quand on est vraiment bien concentré sur le code, de devoir en même temps réfléchir à la formulation de ses commentaires, surtout si c'est du code moins technique et plus fonctionnel.