Dwayne Reid wrote:
>>Unfortunately most people grossly overestimate what is evident from the
>>code.  I think that because at the time it's obvious to them.
>
> Yep - exactly.  I would go one step further and state "I think that
> because AT THE TIME it's obvious to them."
>
> Its when you have to dive into that code weeks or months or years
> later that you realize how short-sited that was.

Haven't had this happen to me recently, which tells me that the level of 
comments is adequate.

One time after the switch, I had to go back to old-style code and make a 
change, and the mess hurt my eyes. Instead of simply wading through the code 
until I could understand what it does, I started refactoring it. A 
super-function several pages long was split up and reduced to a few function 
calls.

When the refactoring was done, making the change was quick and easy. And I 
had a sense of satisfaction, because I left the code in better shape than I 
found it.

Vitaliy 

-- 
http://www.piclist.com PIC/SX FAQ & list archive
View/change your membership options at
http://mailman.mit.edu/mailman/listinfo/piclist