Several discussions here should be making references to literate programming but as far as I can see, haven't. For the curious and/or Knuth fans:

https://en.wikipedia.org/wiki/Literate_programming