RE: Imperatives in procedures?

Subject: RE: Imperatives in procedures?
From: "Nuckols, Kenneth M" <Kenneth -dot- Nuckols -at- mybrighthouse -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 22 Nov 2005 08:41:57 -0500

Jeff Scattini asked...

> >
> > ...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...
> >
> > I'm trying to get a sense if I'm picking a dumb battle...

My question concerns the deliverable format. Are you creating a document
on paper or are you creating online help? If you're creating a paper
(or PDF) deliverable, what options do you have to include graphics or
screenshots? If you can include a detailed screenshot of the user
interface, you might be able to use some sort of callout, highlighting
or pointer to emphasize the location of the element on the screen.

CONFIDENTIALITY NOTICE: This e-mail may contain information that is privileged, confidential or otherwise protected from disclosure. If you are not the intended recipient of this e-mail, please notify the sender immediately by return e-mail, purge it and do not disseminate or copy 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!

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.

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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.

Previous by Author: RE: conference dates clashing w/ special religious days?
Next by Author: Anybody???
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

Sponsored Ads