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.
> Kevin McLauchlan wrote:
>
> > So if there are a several prerequisites, you make them
> > steps 1 through 4, before step 5 gets to the meat of the
> > current procedure?
>
> Indeed. I have always thought the idea of stating prerequisites to a
> procedure is asking for trouble. If there are things you have to do
> before
> step 1, then is isn't step 1, is it?
>
> Numbered steps are like catnip to an impatient reader. We should write
> procedures as if readers do not read anything between the topic title
> and
> the first numbered step.
So-o-o-o-o...
GERUNDISH TITLE
1) Do everything appropriate on <page link1> - if you have not already done so.
2) Do everything appropriate on <page link2> - if you have not already done so.
3) Do everything appropriate on <page link3> - if you have not already done so.
4) Know, without further info, that the following steps are the right thing to
do now, in your situation, or skip the next seven steps.
5) Connect the blah-blah-blah...
??
Or...
GERUNDISH TITLE
1) If blah, blah, blah, then do everything on <page link1>
2) If blah, blah, blah, and blah-de-blah, and blah-de-blah, but not bla-bla, then do (or have done?) everything on <page link2>
3) Etc.
??
- kevin
<bumpfstart>
The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days. http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-