Re: Glossary Predicament!

Subject: Re: Glossary Predicament!
From: kcronin -at- daleen -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 13 Aug 2002 06:49:23 -0600


> I am preparing a product guide for a wireless billing software. Do
> you guys think it would be a good idea to explain terms like 3G,
> 2.5g, 2g and IN in the glossary? Since the product guide would be
> read by people who would like to know the benefits of the
> software, do I assume the reader would be already familiar with
> these terms?
>
> Right now I am thinking insulting the reader's intelligence is a
> far smaller risk than trying the reader's patience. Would like to
> know this list's opinion.


It would only be insulting if it were intrusive. Glossaries typically are
placed at the end of a document, so your reader will only go there if they
need to.

Even industry-savvy folks get lost in the sea of acronyms sometimes, so I
think there's no harm done by including these terms. Doing so also
indicates that your company *understands* these terms.


Keith Cronin
_____________________

The benefits of exercising one's brain on behalf of others shouldn't be
neglected.
-Geoff Hart


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Save up to 50% with RoboHelp Deluxe. Get 2 great products for 1 low price!
You'll get RoboHelp Office PLUS RoboDemo, the software demonstration tool
that everyone's been talking about. Check it out and save!
http://www.ehelp.com/techwr-l

TECHWR-L is supported by ads and sponsorships...and donations.
You can help maintain the TECHWR-L community with donations
at http://www.raycomm.com/techwhirl/abouttechwhirl/donate.html

---
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.


Previous by Author: Re: I'm taking my marbles and going home...
Next by Author: Re: I'm taking my marbles and going home...
Previous by Thread: Glossary Predicament!
Next by Thread: RE: Glossary Predicament!


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


Sponsored Ads