A Philosophy of Software Design

by John Ousterhout

In addition to describing what the code is doing, implementation comments are also useful to explain why.