Re: More on Tech Writing Tests

Subject: Re: More on Tech Writing Tests
From: Eugene Kim-Eng <gene -at- genek -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 11 Feb 2003 13:57:54 -0800


I would *never* hire someone who whose "answer" to "how to make a PBJ"
in online help was like that. This is the sort of extraneous, usertime-wasting
fluff that I've spent years working on writers to cut *out* of technical instructions,
because it results in voluminous tomes that users leave on their shelves unread
while they tie up the phone lines to Tech Support looking for someone who ends
up reading them the numbered steps and causes upper management to regard
technical writers as time and money-wasters who rise to the tops of their layoff
candidate lists.

Gene Kim-Eng
Technical Publications Manager
Half Moon Bay, CA.


At 03:08 PM 2/11/2003 -0500, Laurie Kittle wrote:

The group-voted all-time winner? A nearly-green fledgling tech writer who
chose as her audience visitors to the US from another English-speaking
country:
She began the topic with an explanation of sandwich ingredients, discussed
the kinds of bread that are often used and how they differ, mentioned the
cultural importance of peanut butter and jelly sandwiches in growing up in
America. Then she provided a well constructed step-by-step procedure with an
action/result in each step, including the final steps of putting it on a
plate, cutting in half, and serving.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Buy or upgrade to RoboHelp X3 today and receive the WebHelp
Merge Module for FREE ($299 value). RoboHelp X3's all-new
features include conditional text, completely re-engineered
printed documentation output, Context-sensitive Help Toolkit,
single-source layouts, and more!
Order online today at http://www.ehelp.com/techwr-l


---
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.



Previous by Author: Re: Calling All Cooks & Design Gurus
Next by Author: RoboPdf
Previous by Thread: RE: More on Tech Writing Tests
Next by Thread: RE: More on Tech Writing Tests


What this post helpful? Share it with friends and colleagues:


Sponsored Ads