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.
Subject:Documenting wizards that have numbered "steps" From:l_migliorini -at- yahoo -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 1 Jun 2005 10:36:09 -0600
I am curious to know how others handle the following situation.
I have to document a wizard that has numbered steps - that is, the words
"Step 1 Step 2, Step 3," etc. appear right on the dialog and as part of
the name of that tab.
But of course, in the procedure I am writing, there are a few steps that
you must take before you even get to the wizard Step 1, so the "steps"
will always be out of synch.
I thought of having the main procedural steps and then treating the whole
wizard as just one step. That way the discrepancy between "my" numbers and
the "wizard's" numbers would not be so great:
1. go to such and such and log on
2. navigate to such and such and change your options
3. change the path names and do blah blah
4. Use the Wizard.
a. Step 1
b. Step 2
c. Step 3
d. and so on.
5. do the next step of the main procedure once done with the wizard
6. save and close and so on.
New from Quadralay Corporation: WebWorks ePublisher Pro!
Completely XML-based online publishing. Easily create 14 online formats, including 6 Help systems, in a streamlined project-based workflow. Word version ships in June, FrameMaker version ships in July. Sign up for a live, online demo! 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:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.