You’re commenting your code too much (and other controversial thoughts on documentation)

The best code comment is often no comment at all… before you get out your pitchforks, let me explain.

Over-commented code is often more difficult to understand than code without comments.

Little notes back and forth from all the different maintainers of a project can often get cluttered…