The problem with literate programming - which I absolutely love myself - is that you demand people to be both good coders and good writers. From my personal exp

The problem with literate programming - which I absolutely love myself - is that you demand people to be both good coders and good writers. From my personal experience, there certainly are people who fit the bill, but they are a minority. Being (hoping to be) one of them it took me a long time to understand that not everybody is able to write good prose and good code at the same time... and that there are even people utterly incapable of one of these, while still being proficient in the other. Having said this, encouraging literate programming practices is certainly a good idea, just don't expect it to be a silver bullet for code quality issues.