A Philosophy of Software Design

by John Ousterhout

The only way to describe an abstraction is with comments. If you want code that presents good abstractions, you must document those abstractions with comments.