A Philosophy of Software Design

by John Ousterhout

If interface comments must also describe the implementation, then the class or method is shallow. This means that the act of writing comments can provide clues about the quality of a design;