This is something I really liked when doing Literate Programming at university. It's really nice to be able to wrap the code with written meaning, in a way that regular comments don't do as well.
Recommended read: Literate DevOps http://www.howardism.org/Technical/Emacs/literate-devops.html