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.
>This sentence is very simple and is fine the way it
is. A very complex sentence may need additional
Quick, what's the golden rule of technical
communication..."Know your audience?"
The responses to this sentence are examples of how we
forget to take a good look at our readers. Raj says
it's necessary, Lauren says it's not, Ned says maybe,
but nobody suggests that the audience is the key to
the proper usage.
If your audience is made up of average, native English
speakers, then you've got no problems with the current
version. But, what if you're going to translate it or
expect non-native English speakers to interpret it on
their own? Don't count on the translation coming
across clean in every language - taken separately,
"will draw" and "write" are two different verb tenses.
Regardless of how clear we think the implication is in
English, it may not be clear to the audience. Unless
you remove the ambiguity, you take the risk that the
meaning could get lost in translation.
Audience is king...only when you define your readers
can you bank on having the right answer.
Suwon, South Korea
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-