[diskzero]

If you want to go down the Literate Programming rabbit hole with me, I have a lot of ideas around that. Your system could be applied to parsing source code and coming up with conversational descriptions, or even more exciting, going from conversation, descriptive text into source code. You are in the process of building a corpus that can used in both directions.

As for the text layout, just something a little prettier with improved spacing between descriptive blocks, bullet point and links that reference to the parsed source code. It should be just as pleasant to look at as any well-designed piece of online prose. I realize that design is subjective.