On: Myths about code comments

[j_baker]

You and I have different experiences then. I've seen people who comment everything and anything. And I know I'm not the only person who has seen this:

http://steve-yegge.blogspot.com/2008/02/portrait-of-n00b.htm...

[tentonova → j_baker]

And since it's Steve Yegge, it must be right?

His "over-commented" example is clearly extreme hyperbole.

His under-commented counter-example is extremely poorly commented code which fails to explain the "why", ensuring that nobody can make sense of the code path without actually stopping to read the entire expression and possibly the expressions to which it refers.