You should probably use a MOOSE image if you want to do the modern equivalent of literate programming. Instead of comments, drive your code from (behavioural) tests, create glamour & mondrian browsers to visualize the design and quality attributes of the code and use magritte style descriptions to declaratively describe your domain. Then generate LaTeX & pictures from this for the paper trail.
Stephan Eggermont