AHTOH (vorobiev) wrote,

Some words about technical writing

Just found http://www.sysprog.net/quotwrit.html Few fun quotes:
  • Rule 1 of writing software for nontechnical users is this: if they have to read documentation to use it you designed it wrong. (Eric Raymond)
  • I've never met a human being who wouldwant to read 17,000 pages of documentation, and if there was, I'd killhim to get him out of the gene pool. (Joseph Costello)
  • Report-writing, like motor-car driving andlove-making, is one of those activities which almost every Englishmanthinks he can do well without instruction. The results are, of course,usually abominable. (Tom Margerson)
And the best one: Documentation is like sex; when it's good, it's very, very good, and when it's bad, it's better than nothing. (Dick Brandon)
Tags: Смешно
  • Post a new comment


    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened

    Your IP address will be recorded