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:Re: In reference to number of steps From:"Dan Roberts" <droberts63 -at- earthlink -dot- net> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 19 Oct 2000 19:09:01 -0400
>It seems to me that in performing a procedure, one needs to do whatever
>it takes to complete the procedure. No more. No less. If there are 15
>steps in a procedure, or if there are 50 steps, that is really a
>function of how the procedure was designed, which is not a writing
>function but a system design function.
>
>The writing function is to document the procedure, step by step, from
>beginning to end. Setting an arbitrary limit of 5, 7, or 9 steps would
>seem to me to lead to procedure "steps" where more than one action was
>included in one step simply to keep within this arbitrary number.
>
I dunno. 50 steps would lead me to think "Gawd, does it ever end?" So even if
all 50 steps are in one flow, and that flow can be ...not broken out, no
subdivided, not sectioned...perhaps "phased" is the word I want...phased into a
few main phases, then I can hold that idea in my head better. And I guess, if
you can determine "phases" then steps 14-26 are simply little parts of one major
step.
>I much prefer to see procedures that are one step per task. (Do this;
>this happens. Do that; this other thing happens.)
Just out of curiosity, what do you do when there are bunches of fields to fill
in one window/dialog/panel--is each field a step, or are they all pieces of the
one step of filling out the window/dialog/panel?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Learn how to develop HTML-based Help with Macromedia Dreamweaver!
Dec. 7-8, 2000, Orlando, FL -- $100 discount for STC members. http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Your web site localized into 32 languages? Maybe not now, but sooner than
you think. Download ForeignExchange's FREE paper, "3 steps to successful
translation management" at http://www.fxtrans.com/3steps.html?tw.
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.