http://akkartik.name/post/comprehension
Instead, let’s focus on guiding exploration, making it easier for readers to answer their own questions about codebases. I’m still figuring out how to do this; so far I have just a couple of preliminary ideas: