Software Development/Literate Programming

In spite of what I said about comments and self-documentation, sometimes I really want to expound on the meaning of my code, and literate programming is the way to do it.

• Literate programming - Wikipedia
• Literate programming: Knuth is doing it wrong - Kartik Agaram

Python tools:

• pyWeb - After glancing at a few, I chose pyWeb as probably the closest to what I was looking for.
• Pweave - A feature-rich tool I might try at some point.

My first attempt at literate programming is my Math Student Simulator. See the README for basic details on writing and processing the source files.