A Philosophy of Software Design

by John Ousterhout

The biggest challenge with cross-module documentation is finding a place to put it where it will naturally be discovered by developers.

I think a general notes.txt is a good place to define this within the project.