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.
>Do you talk about target audience before doing this exercise? It sounds
like
>a cute schtick, but unless your target audience is aliens with no jars or
>similar items in their culture, and no concept of gravity, can't you assume
>that your target audience, if they're savvy enough to read instructions,
can
>also figure out that jelly falls out of an upturned jar?
Amen to that.
As communicators we should know better than to set up an example for which
the correct amount of documentation is none. Just because an exercise is fun
and engaging does not meant that it is demonstrating the right thing. To
repeat what I said yesterday on a related topic, the wrong thing done well
is still the wrong thing.
If people want an exercise which has legitimate real world content I suggest
the following:
You have been interviewed for a national television program. Your
grandmother wants to see you on the show, but she will be away from home the
day it is on.
Write a letter to your grandmother telling her how to program her VCR to
tape your show.
To test the result, send your letter to your actual grandmother.
(And no slight to the technical savvy of grandmothers is involved here.
Different grandmother's will require different instructions, based on their
technical knowledge and skill. Know your audience.)
---
Mark Baker
Senior Technical Communicator
OmniMark Technologies Corporation
1400 Blair Place
Gloucester, Ontario
Canada, K1J 9B8
Phone: 613-745-4242
Fax: 613-745-5560
Email mbaker -at- omnimark -dot- com
Web: http://www.omnimark.com