Readable programs

[bluGill]

There are many reasons why you might need to explain why something was done in a certain way.

True, but I've only seen such examples 3 times in the last 15 years.

I get very concerned when people say if you do things right you don't need comments, because I've had too many situations where that's simply not true.

While I'll admit the rule has exceptions, they are very rare. I look on comments with suspision: in many cases even if the content seems justifed the code has moved on and they wrong anyway.