Category Archive for Technical writing

Over the summer, my friend invited me to join her food blog as a guest author so I could write about my explorations as a newly re-minted tea junkie. It seemed easy enough — just click on the link in the e-mail sent by Blogger and 1-2-3, ready to write.
The page I landed on was [...]

In my day job, I’ve been working a lot the last few weeks with requirements documentation and test cases. These have been huge documents for the last year — hundreds of requirements and associated test cases — that were being maintained in Word and Excel until we finally got access to the client’s requirements management [...]

Returning to the Geek Squad profile on “60 Minutes,” there was another comment that stood out to me (emphasis added):
New York school teacher David Barkhymer, who considers himself a bit of geek, fell into the last category: he spent three days trying to hook up his new 32 inch HDTV, plodding through menus and a [...]

How much of the public’s current woes with technology (and services) could be alleviated by better documentation?
Leaving the topic of product design (which is where problems are really started…or averted) to folks like Creating Passionate Users, I’ve long believed that better documentation and better product testing could go a long way toward reducing user frustration [...]