TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
> >
> > ...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! 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-
