A Philosophy of Software Design

by John Ousterhout

When writing comments, try to put yourself in the mindset of the reader and ask yourself what are the key things he or she will need to know.

The good old' adam smith imagination trick :)