The Dirty Truth Behind Documentation

Here’s an oldie-but-goodie single panel PCW toon that’s been spruced up for your viewing pleasure. (The original was published back in 2007). If you haven’t seen it, it’s probably new to you. :)



These beautiful and intelligent people wrote

  • Kevin RubinReply
    May 10, 2010 at 10:41 am

    Boy, don’t I know it… I’ve written a bit of technical documentation in the past with no obvious sign that anyone read it.

    On the other hand, I worked with a tech writer who didn’t even read her own stuff… Once a few weeks after I walked her through (i.e. mostly dictated) writing a technical article on how to map a drive in Windows she had some problem with her computer. Me and another guy said “well, map your drive so we can look at it” and she said “tell me how to do that.” We pointed out “you wrote the instructions!” but she said she couldn’t read it and understand it…

Tell me what you think!