From: Tom Ayerst <twa@...>
Date: 2005-04-30T16:34:27+09:00
Subject: Re: Comments Are More Important Than Code

Mark Smith wrote:
> James Britt said the following on 4/27/2005 7:14 PM:
> 
> 
> 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 . . .
> 

On the other hand having the loop in a method called report_formatter 
calling two methods called "even_number_page_formatter" and 
"odd_number_page_formatter" would do that too...

<fx:ducks> ;-)