TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I've held back comments on this topic, but would like use the impromptu case
study to learn from from it.
Case study:
Cooking instructions on the Kraft Dinner box are reported to be unclear to
some adults and children. It seems that novices to food preparation may not
distinguish stovetop and microwave instructions as two discrete processes,
and instead perform both sets of instructions, leading to less-than-savory
(pun intended) results.
Case study conclusions:
1. The instructions seemed clear to the writer.
2. The instructions turned out to be unclear to some of the audience.
3. The writer made assumptions about the audience but did not test those
assumptions.
4. If the assumptions were tested, the test was unsound (otherwise, the
instructions would be clear to the audience.)
Lessons learned:
1. Do not make assumptions about the audience.
2. Do not rationalize your mistake by becoming defensive(e.g. "why are kids
being allowed to cook Kraft Dinner anyhow").
3. Use the feedback you receive to improve your instructions (e.g. you may
discover that novices are more likely to venture into food preparation with
a product such as Kraft Dinner).
4. Test or, if you've tested, use an iterative process until you get it
right.
5. Keep your sense of humor. After all, who could have predicted that
MacDonald's would have to label coffee as "hot" because customers burned
their mouths? Or is that lesson: never underestimate the softheadedness of a
percentage of consumers? ;-)
Rahel Bailie
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY. http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Sponsored by DigiPub Solutions Corp, producers of PDF 2001
Conference East, June 4-5, Baltimore/Washington D.C. area. http://www.pdfconference.com or toll-free 877/278-2131.
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.