I recently read Don Knuth's "Literate Programming". It seems to me that a lot of writing on the web ignores the main point of literate programming. The main point is not to mix comments and code. That is pretty easy to do in most languages.

What Don is really talking about is how to lay out your program so that it's layout matches the way we think rather than the way a compiler works.

When I write a program (when I am not using XP and when I am not pairing) I spend some