in reply to Too much documentation?

Well my opinions on comments seem to be an extreme around here. But read the entire thread starting at Re (tilly) 2 (disagree): Another commenting question, (and keep in mind that behind the scenes we were exchanging much more pleasant /msgs) to see my personal style laid out.

In there I lay out in quite a bit of detail my opinions on ways in which commenting can be negative, what needs comments, what does not, and how to comment. As you will see reading that, the question isn't really the density of comments. It is instead what do you comment, why do you comment, how do you comment, and in what ways do you make your code descriptive?