A Philosophy of Software Design

by John Ousterhout

Another way of thinking about obviousness is in terms of information. If code is nonobvious, that usually means there is important information about the code that the reader does not have: