From: Adelle Hartley <adelle@...>
Date: 2005-04-28T19:08:33+09:00
Subject: Re: Comments Are More Important Than Code

Mark Smith wrote:
> Of course, a comment like "Step through by twos" does NOTHING 
> to help a code reader understand that the loop is stepping by 
> two's.  However, a comment like "Apply this to the even pages 
> in the report" explains to a code reader WHY the loop is 
> stepping by two's . . .

That sums up my policy.

To coin an aphorism, your programming language is well documented, your
application is not.

Adelle.