I fully agree with this and the grandparent.  I&#x27;ve written a handful of literate programs, and I found that it worked nicely for a parser, which read from top to bottom in a single file, and it worked quite well for some unit tests, where the extra documentation and the tests themselves - which are quite self-documenting anyway - sat together rather nicely (though it was less well-received by my colleagues, who decried it as neurotic and pointless).  My other attempts - particularly a small web app with a bunch of GUI components - were much less successful.