From: Dave Fayram Date: 2005-04-30T08:21:03+09:00 Subject: Re: Comments Are More Important Than Code On 4/29/05, Lorenzo Jorquera wrote: > > Wrong answer. You still are not documenting the "why". > > Comments tell you what the code *SHOULD* be doing, not *WHAT* it is > doing. So many people responding to this thread seem oblivious to this > obvious, yet subtle and important fact. > At what point did such a claim become fact? As much as I may believe in and hype my development practices and philosophy, I'm not going to claim that they're fact. Other ways of doing things exist... Some of them just aren't very efficient. But you're claiming this is a "subtle but important fact?" Please try not to confuse your preferred development philosophy with fact. It isn't good for this discussion. The fact that we can even have such a heated debate over comments should tell you that no one here is 100% right. -- -- Dave Fayram (II) dfayram@lensmen.net dfayram@gmail.com