[bheadmaster]

> It adds overhead to refactoring. Refactoring code now means editing and rewriting a book

In my opinion, this is a good thing. The problem with ordinary refactoring is that it's too easy to just shuffle things around until they work/seem nicer/do whatever you want to. However, with literate programming, you have to think why you're refactoring, and how does it reflect in the explanation.