I really like Marginalia if you want to take something like a literate programming approach. Marginalia traverses your source code, and produces an html formatted version with comments set beside code in a very clear text. Comments can be markdown formatted, making for a very readable final document. When reviewing source code that I’ve written … Read more
I used to write a lot of literate programs. What do you write as Haddock comments and what do you write in the literate part? The external API documentation goes into the Haddock comments. Everything else goes into the literate part. “Everything else” might include: Internal invariants of data structures Why you are doing things … Read more
I have written Pweave http://mpastell.com/pweave, that is aimed for dynamic report generation and uses noweb syntax. It is a pure python script so it also runs on Windows. It doesn’t fix your indent problem, but maybe you can modify it for that, the code is really quite simple.