Look at Knuth's Adventure example: http://www.literateprogramming.com/adventure.pdf
Plenty of code with your prose there.
Plenty of code with your prose there.
Take a look at section 6. There's a flowery sentence that says no more than "Add word to vocabulary" (completely pointless if this were a method called "add_word" on a class named "Vocabulary") and then a dense chunk of completely unexplained code.