A Philosophy of Software Design

by John Ousterhout

Interface comments provide information that someone needs to know in order to use a class or method;