in reply to
Strategy in Comments, Tactics in Code
in thread The art of comments: (rave from the grave)
Two, I have a technique I teach to any new programmer, whether they're under my supervision or not: write the comments first. Programming courses always talk about writing pseudocode: why write it on scratch paper, just to throw it away?
That leads to the archetypical example of bad comments:
$counter ++; # Increment the counter.
Pseudocode gets replaced
, not supplemented. It's thrown away because there's something better: the real code. Comments are not a replacement for pseudo-code.