How to Write Really Good Documentation: Donald Knuth Was Wrong
http://www.redhatmagazine.com/2007/04/18/how-to-write-really-good-documentation-donald-knuth-was-wrong/

Forte, Brian
Red Hat Magazine
2007

Abstract:

In the continuing absence of maturity in the software world, it’s the documentation that has to treat the tool-user with respect. Which is a further argument against Knuth’s Literate Programming. Since it’s all too common to see software toolmakers treat tool-users with short shrift, it’s a useful caution to have the ’software is written in one corner and documented in another’.