I read the literate programming publication this morning which was very interesting. I'm writing my vim config using "literate" which is like WEB but for markdown + any language. It claims to help with this context problem.
I wish the code I encountered had more context. I try to write really good commit messages so that blame contains my rationale
@dominicm you have links to the “literate” markdown tool, and the publication?
http://literate.zbyedidia.webfactional.com/manual.php tool I'm using. Publication referenced http://www.literateprogramming.com/knuthweb.pdf There's a book too I think.