A Philosophy of Software Design

by John Ousterhout

It’s important that readers can easily find all the documentation needed to understand your code, but that doesn’t mean you have to write all of that documentation.