From: Sy Date: 2005-04-28T04:22:24+09:00 Subject: Re: Comments Are More Important Than Code On 4/27/05, Dave Fayram wrote: > > I'm a big fan of documentation and code that lends itself to the > reader, and Ruby helps me with this, but my feeling is thatif your > methods are so long that they require comments, then your methods are > too long. Sure, there are exceptions to this (explaining a tricky step, > saying why a non-obvious piece of code exists, naming a pattern or > algorithm), but in general I think this is a reaction to bad coding > practice. Well said. I love the idea of documentation-style commenting. It's truly a nice "in a perfect world" concept. However, I can imagine how much extra a nightmare it would be for a coder to be hacking away and then have to step outside of that mindset to fiddle with the english language and fix comments. Just who would be writing and maintaining all that "commenting" anyways? The programmer is who.. so its style follows the programmer's mindset.. concise.. so they can move on to the next real issue --> more programming. As soon as coders start leaning towards documentation.. the entire "programming" thing suffers.. unless there's some sort of freakish new vat-grown breed of programmer+documenter that I'm not aware of. Well.. ruby might be easy enough on the brain that it leaves more time to think about such things. Scary.