>>Perhaps most importantly, you may find that, like literate programming, the effort to explain your decisions and implementation in prose may very well improve the code.

Im hoping this is the case.