A Philosophy of Software Design

by John Ousterhout

the farther a comment is from the code it describes, the more abstract it should be (this reduces the likelihood that the comment will be invalidated by code changes).