RE: Repeating Steps Task

Subject: RE: Repeating Steps Task
From: Karen Field <kfield -at- STELLCOM -dot- com>
To: "'Mason, Catheryn'" <CMason -at- INFINITEC-COM -dot- com>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 27 Oct 1999 17:09:47 -0700

The question seems to be: conditional info first, or action info first? To
illustrate why I believe it's best to put the conditional info first, I'll
use an example from a friend who used to teach Drivers Ed (in the car). He
said, "I've learned to tell a new driver __when__ to do something before
telling them __what__ to do. For example, 'At the stop sign, turn left.'
Otherwise I find drivers will end up turning and parking on somebody's
lawn."

Karen Field
Sr. Technical Writer
Stellcom, Inc.
kfield -at- stellcom -dot- com


-----Original Message-----
From: Mason, Catheryn [mailto:CMason -at- INFINITEC-COM -dot- com]
Sent: Wednesday, October 27, 1999 1:26 PM
To: TECHWR-L
Subject: RE: Repeating Steps Task


A poster at Ace Hardware inquiries about documenting repeated steps
-- "some of us are stating "Repeat steps 2 and 3 to/until...", while
others are stating "In order to..., repeat steps 2 and 3". "

When I use repeated steps, I specify the condition to be met first, then
specify the steps to be repeated. For example, "If additional transport
facilities are required, repeat steps 2 and 3." In other words, I supply the
reason or outcome first, followed by the action.

My two cents -- others may differ.

Catheryn Mason, Technical Writer
Infinitec Communications
cmason -at- infinitec-com -dot- com
Winner, 1999 IABC Bronze Quill Award of Excellence for Technical Writing


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Sponsored by Weisner Associates Inc., Online Information Services
Moving your documentation online? We can help with standards, planning,
or training. Visit us at http://www.weisner.com or mailto:info -at- weisner -dot- com -dot-

Sponsored by Rose Hill, Your Business and Career Coach.
"Assume Success! Live Your Passion!" Get the gist at
www.coachrose.com then call 503.629.4804 for details!

---
You are currently subscribed to techwr-l as: kfield -at- STELLCOM -dot- com
To unsubscribe send a blank email to $subst('Email.Unsub')
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: Numbering the headings. What is the point?
Next by Author: RE: Repeating Steps Task
Previous by Thread: RE: Repeating Steps Task
Next by Thread: Re: Repeating Steps Task


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

Sponsored Ads


Sponsored Ads