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: 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
George,
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
www.juliasugarbaker.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.
Hayhoe
Sent: Sunday, November 07, 1999 8:20 AM
To: TECHWR-L
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
scale.
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.
Winner
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 http://www.weisner.com 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. http://www.digipubcorp.com, 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 http://www.raycomm.com/techwhirl/ for more resources and info.
