A Philosophy of Software Design

by John Ousterhout

The main goal of implementation comments is to help readers understand what the code is doing (not how it does it).