A Philosophy of Software Design

by John Ousterhout

The best time to write comments is at the beginning of the process, as you write the code. Writing the comments first makes documentation part of the design process.