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.