Bill wrote...

> People say that 'code should be commented' like writing good comments is
> easy.  In fact, writing good comments isn't easy at all, and bad comments
> can be worse than no comments at all.  I don't know how often I've gone back
> and looked at old code (of my own!) to find that I didn't comment the part
> that was now mysterious, or that I documented HOW it worked but not WHY I
> was doing that, or that I documented WHY I was doing something, but didn't
> give a clue as to HOW the code was supposed to accomplish that.

Being a moderate and just person myself  I have a simple rule.....
Any of my techs that write code without comments that make sense will
be beaten to death with a wet bus ticket.
Mind you I will have to get the old bus ticket out for myself when I
designed a power switching arrangement that blew up 8 mosfets...
The correct alterations were made at the time... all worked hunky
dory... we built another unit, I had not changed the schematic... and
it happened all over again.
_____________________________

Lance Allen
Technical Officer
Uni of Auckland
Psych Dept
New Zealand

www.psych.auckland.ac.nz

_____________________________