A Philosophy of Software Design

by John Ousterhout

Sometimes it isn’t possible to avoid code that is nonobvious. When this happens, it’s important to use comments to compensate by providing the missing information.