Re: Are your documents interesting?
Of course the answer is yes! The challege to us tech
writers is convincing management that users are,
well...just like us! They laugh and cry. They watch
the same TV shows, read the same magazines. They speak
informally. Why does the tone of our documents and
training not reflect what people are used to
experiencing in the larger marketplace?
All together now: IT DEPENDS.
We've had numerous go-rounds on the list about when, where, and if humor, for example, has a place in tech writing. And we just had a thread about contractions. The same considerations apply to conversational writing style in general.
In the instructions for swapping out a coolant pump on a nuclear reactor, you probably don't want to be too loosey-goosey with the language. Or in the instructions for filling out the forms for Medicare Part D, either. The user guide for the latest video game is another story.
The two big considerations, from management's point of view, are:
1. Is there a chance that someone with limited reading skills is going to misunderstand the document and end up causing harm to budget, equipment, or persons?
2. Is it going to cost extra to hire writers capable of writing an interesting document?
If you can answer No to both questions, go for it.
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author content and configure Help in MS Word or any HTML editor. No proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com
To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.
- Re: Are your documents interesting?, John Cook
Are your documents interesting?: From: Steven Brown
Previous by Author:
Re: Do Burned CDs Have a Short Life Span?
Next by Author: Re: Examples of good tech writing?
Previous by Thread: Are your documents interesting?
Next by Thread: Re: Are your documents interesting?
Search our Technical Writing Archives & Magazine