If you are interested in this kind of documentation (or style in general), you should check out literate programming. Some of Knuth's ideas are implemented as code processors for almost any programming language.