A Philosophy of Software Design

by John Ousterhout

If information is already documented someplace outside your program, don’t repeat the documentation inside the program; just reference the external documentation.