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.