re: Imperatives in procedures?

Subject: re: Imperatives in procedures?
From: Steven DeWitt <news -at- stevendewitt -dot- ca>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 22 Nov 2005 10:25:34 -0400

Hi Jeff,

The guideline I follow is to put the imperative at the start unless the reader absolutely needs to know other information first in order to avoid "Throw out bathwater (after removing baby)" situations. If there is navigation info that the reader needs to know, is it possible to put it at the end of the previous instruction instead of at the start of the next?

Good luck

Steven

--
Steven DeWitt, C. Tran. (FR>EN, ES>EN, en>fr)
Fredericton NB CANADA
mail [at] stevendewitt [dot] ca


Le 21-nov-2005 à 17:51, Jeff Scattini a écrit :


Hi all,

I'm currently writing a series of task-oriented documents for a
software application.

I learned that one should always put the user-imperative at the
beginning of each step:

1. Click Start on the toolbar.
2. Select the program you want and double click that program.

However, one of my product managers wants to bury the imperative in
surrounding text:

1. On the left-hand side of the toolbar, click the Start button.
2. You can from there, search for the program that you want and then
click that program to open it. The program window will then open.

I have searched the MS Manual of Style, (which is what we've used as a
starting point for our in-house style guide) and it states that you
can put the navigation before the imperative. Our in-house style guide
states to use the imperative first, but the in-house styles are less
than 6 months old and still fairly fluid.

I'm trying to get a sense if I'm picking a dumb battle or if people
have found that using the imperative is more or less usable for their
readers.

Thanks,
Jeff
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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 news -at- stevendewitt -dot- ca -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/news% 40stevendewitt.ca

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



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

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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: Re: Cobra or COBRA
Next by Author: Friday article: But Can You Teach?
Previous by Thread: RE: Imperatives in procedures?
Next by Thread: Re: Imperatives in procedures?


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


Sponsored Ads