RE: Need a word

Subject: RE: Need a word
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Butler, Darren J Ctr 584 CBSS/GBHAC" <Darren -dot- Butler -dot- ctr -at- Robins -dot- af -dot- mil>, <tech -dot- writer1 -at- verizon -dot- net>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 14 Nov 2007 15:31:12 -0700

Butler, Darren J wrote:

> > A task is _what_ to do; a procedure is _how_ to do it. To
>
> complete a task, you follow one or more procedures. And a set of steps
>
> is a procedure.
>
> True, but I don't see how that is much different from what
> Joyce and I suggested. I'm not sure where is the gap?

You both defined a set of steps as a task and eliminated "procedure." I
disagree. Performing the steps is how one _proceeds_ to accomplish the
task; thus, a _procedure_.

I realize I'm being a curmudgeonly old pedant, but I still insist that
words aren't arbitrarily chosen collections of sounds/syllables. They
represent concepts that relate to each other, often through a shared
concept that's apparent from the shared root of the words. Thus, a
procedure is how one proceeds; a task is not.


> >There's no need for the complexity and vagueness of "sub steps"
>
> "sub steps" are complex *and* vaugue?
>
> Could you explain further?

I find "sub step" vague in this context because it's an artificial
construct that's being used in place of the right word (as I noted
above, there *is* a right word for how one proceeds). We could call
tasks "payoffs," procedures "struggles," and steps "moves," but would
that help or hinder understanding?

You suggested "sub steps" because in the situation tech.writer1
described, procedures were mislabeled "steps," so she/he needed a new
word for the steps themselves. It would be clearer to the reader to call
a procedure a procedure and not have to introduce a new term for a step.

I find "sub step" complex because even when used in the right context,
it's almost always an unnecessary devolution of "step." Steps 1, 2, and
3 are steps; but so are steps 1, 2a, 2b, and 3. There's simply no need
to subdivide the category (unless you're discussing formats/styles,
layout, etc.).

Remember: "I never lie and I'm always right." ;-)

Richard


------
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------






^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


References:
RE: Need a word: From: Butler, Darren J Ctr 584 CBSS/GBHAC

Previous by Author: RE: Need a word
Next by Author: RE: STC Salary data collection
Previous by Thread: RE: Need a word
Next by Thread: RE: Need a word


What this post helpful? Share it with friends and colleagues:


Sponsored Ads