A Philosophy of Software Design

by John Ousterhout

if there’s no way to describe a method completely without a long and complicated comment, then the method has a complex interface.