“Rob Pike, in his essay “Notes on Programming in C”, says
that he tends to err on the side of commenting less, rather than
more. There appears to be a school of thought that has taken this
one step further, and believes that comments are at best a
necessary evil, and that good code should be self-evident enough to
obviate the need for comments.”
“Bull.“
“Yes, you should be writing code that’s clean enough that you
don’t need to explain what it does. But the code only tells you
what the code does; it doesn’t tell you what the code was intended
to do, what it ought to do, what it doesn’t do, or why it looks the
way it does.”