On Comments

My default approach to comments is: don't. I'm not talking about documentation, such as API docs, but about comments in the source code of the implementation.

First, let my explain why I generally consider comments harmful — and then let's talk about the two exceptions, when I actually defend and demand …