A Philosophy of Software Design

by John Ousterhout

The overall idea behind comments is to capture information that was in the mind of the designer but couldn’t be represented in the code.