A Philosophy of Software Design

by John Ousterhout

First, it produces better comments. If you write the comments as you are designing the class, the key design issues will be fresh in your mind, so it’s easy to record them.