Re: a question about writing instructions

Subject: Re: a question about writing instructions
From: Maggie Pierce Secara <maggiros -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 6 Feb 2003 13:52:11 -0800 (PST)

I hate that style. It's backward-looking, and useless.
I thought we were all past this.

Also, burying the instructions in an ordinary
paragraph makes it very hard for the user to find what
they need to do the job! Life is hard enough. Don't
make it a scavenger hunt as well.

A few years ago I started a new job where that was the
"house style" more by default than that anyone had
decided that was the best way to write procedures. I
changed it.

Maggie Secara

--- Becca Price <becca_price -at- yahoo -dot- com> wrote:
> I recently started in a new position where the house
> style is to
> not write out instructions as steps, but rather in
> narrative
> form.

Maggie Secara

The Elizabethan World is at
New in the Compendium! Keeping an Elizabethan Christmas

Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.


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

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 for more resources and info.

a question about writing instructions: From: Becca Price

Previous by Author: Re: PM/Tech Writer/Security
Next by Author: Re: a question about writing instructions
Previous by Thread: Re: a question about writing instructions
Next by Thread: Re: a question about writing instructions

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

Sponsored Ads