A Philosophy of Software Design

by John Ousterhout

The reason for writing comments is that statements in a programming language can’t capture all of the important information that was in the mind of the developer when the code was written.