RE: Are these words being used?

Subject: RE: Are these words being used?
From: "JULIA M COUNTRYMAN" <JULIA -at- juliasugarbaker -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sun, 7 Nov 1999 09:01:51 -0800


I think you make a very valid point, but I will be darned if I will ever use
a word that has a questionable existence at an SME's insistence, even if it
is commonly used within the confines of the office or corporate environment.
Besides what we're talking about here is not a technical term, which has
much more leeway as far as its usage, but a word form that doesn't exist (at
least not in the Oxford Dictionary), so in this case, my reply would be "I
ain't gonna use it."

Julia M. Countryman
WordWright Sugarbaker Press
Contract and Freelance Writing, Editing and Self-publishing.
julia -at- juliasugarbaker -dot- com
(949) 551-5211
"If you can't explain it to an 8-year old, then you don't understand
-- Albert Einstein

-----Original Message-----
From: bounce-techwr-l-20181 -at- lists -dot- raycomm -dot- com
[mailto:bounce-techwr-l-20181 -at- lists -dot- raycomm -dot- com]On Behalf Of George F.
Sent: Sunday, November 07, 1999 8:20 AM
Subject: RE: Are these words being used?

Bob Morrisette asked whether "orderability" and
"shippability" are valid words for use in a document he's
working on, as the SME on the project maintains.

I'm not an expert in either materials warehousing or order
fulfillment, the subject areas I'd guess this project
relates to, but the decision of whether or not to use these
terms must be made based on the familiarity of the terms to
the document's audience. This is precisely the reason why we
need to do user and task analysis. If these terms are used
by the document's potential audience to the exclusion of any
other, it doesn't matter that we might think they sound
funny. They're the users' terms of choice and should be used
in the document. We shouldn't substitute other words because
we think these are jargon and thereby risk confusing the
reader. On the other hand, if the words are the SME's and
the potential audience uses other terms, we need to find out
what those terms are and use those words in the document.

This is a relatively easy task if the document is going to
be used in-house. You go to the warehouse or the order
fulfillment center and interview some sample users. You
collect examples of documents they've produced themselves
(desktop procedures or job aids). You examine field names in
existing databases.

If the document will be used by a much larger audience (for
example, if the product it will be used with is offered for
sale), you need to do the same kinds of things on a larger

My guess is that having done the user and task analysis, Bob
will find that these words are the SME's choices and are not
widely used by others. But if this is an in-house project
and that SME has trained all or most of the potential users,
"shippability" and "orderability" may well be the terms to
use in the document.

--George Hayhoe (george -at- ghayhoe -dot- com)

George Hayhoe Associates
Voice: +1 (803) 642-2156
Fax: +1 (803) 642-9325

APEX '99 Grand Award for Publication Excellence

Awards of Distinguished Technical Communication
South Carolina/Carolina Foothills STC Chapters
1998-99 Technical Publications Competition

Sponsored by Weisner Associates Inc., Online Information Services
Moving your documentation online? We can help with standards, planning,
or training. Visit us at or mailto:info -at- weisner -dot- com -dot-

Sponsored by DigiPub Solutions Corp. Make your team FrameMaker experts with
our Power User training for Adobe Acrobat and FrameMaker. Delivered at your
U.S. site or ours.,
mailto:trainme -at- digipubcorp -dot- com

You are currently subscribed to techwr-l as: julia -at- juliasugarbaker -dot- com
To unsubscribe send a blank email to $subst('Email.Unsub')
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: RE: Are these words being used?
Next by Author: RE: Insert Watermark in a Master page in Frame
Previous by Thread: RE: Are these words being used?
Next by Thread: RE: Are these words being used?

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

Sponsored Ads

Sponsored Ads