I've also tried several times literate programming. I actually like it for small libraries that requires a good documentation but little maintenance. What I li

I've also tried several times literate programming. I actually like it for small libraries that requires a good documentation but little maintenance. What I like in this experience is how literate programming forces me to spell out each of my assumptions and justify every choice, just because I then have to program with the reader in mind. And I found that sometimes those assumptions were not as sound as I though. For that reason I would recommend anyone to give it a try. By the way, I also had to write my own tool, extracting the code from the documentation instead of generating both code and documentation, which allowed me to use both my favorite document format and programming language.