A Philosophy of Software Design

by John Ousterhout

Most methods are so short and simple that they don’t need any implementation comments: given the code and the interface comments, it’s easy to figure out how a method works.