A Philosophy of Software Design

by John Ousterhout

Obscurity occurs when important information about a system is not obvious to new developers. The solution to the obscurity problem is to write code in a way that makes it obvious;