RE: Jargon Lovin' Fool

Subject: RE: Jargon Lovin' Fool
From: "Michele Marques" <marquesm -at- autros -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 22 Oct 2001 09:58:59 -0400

I think that there are several solutions, but the main point is to:
* know thy audience
* know whether learning the jargon term might help your audience better
(e.g., when dealing further with the issue, calling tech support, etc.)

For example, if most of your audience isn't setting up the network for the
product (i.e., it's already set up for them and by other people), maybe you
don't need to include the term DHCP in the main flow. On the other hand, if
this is a networking product or the computer is likely not already on the
networking, DHCP may be a relevant term in the main flow.

Note that in both cases, there may be additional exposition included in a
glossary or appendix. In the case where your audience doesn't need to know
about DHCP, you might include a network trouble-shooting appendix that
includes an explanation of DHCP.

In the case where your audience needs to know about DHCP, you might include
a glossary of jargon terms that explains it. If you think your audience
might not know what DHCP is, you might even explain it in the main flow, the
first time you mention it. If most of your audience should be familiar with
the term, then just you might choose to just include it in the glossary.

If you have different audiences with different levels of literacy, you might
include multiple sections to the glossary. For example, one section of our
audience includes many people who have never used Windows before. In the
glossary, I have two sections: one labeled "Windows Terminology" and the
other labeled "AUTROS Terminology". Another approach is to include a
separate section at the start that is labeled an "introduction to" or
"overview of" whatever concepts part of your audience needs - the other
people will just skip over that section.

Michele Marques, Technical Communicator
AUTROS Healthcare Solutions, Inc.
marquesm -at- autros -dot- com <mailto:marquesm -at- autros -dot- com>

This material is intended for the use of the individual
to whom it is addressed and may contain information that
is privileged, proprietary, confidential and exempt from
disclosure. If you are not the intended recipient or the
person responsible for delivering the material to the
intended recipient, you are notified that dissemination,
distribution or copying of this communication is strictly
If you have received this communication in error,
please contact the sender immediately via e-mail and destroy this message

Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

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 for more resources and info.

Re: Jargon Lovin' Fool: From: Bruce Byfield

Previous by Author: RE: The mighty T-Letter
Next by Author: RE: Alternative style for long, form-based procedures?
Previous by Thread: Re: Jargon Lovin' Fool
Next by Thread: Re: Jargon Lovin' Fool

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

Sponsored Ads