Perl Monk, Perl Meditation | |
PerlMonks |
Re^2: The art of comments: (rave from the grave)by Anonymous Monk |
on Jul 07, 2005 at 15:18 UTC ( [id://473121]=note: print w/replies, xml ) | Need Help?? |
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: 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.
In Section
Meditations
|
|