A Philosophy of Software Design

by John Ousterhout

Well-written comments are not failures. They increase the value of code and serve a fundamental role in defining abstractions and managing system complexity.