Subject: Glossary
From: "Nealon, Jessica" <Jessica -dot- Nealon -at- McKesson -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 18 Oct 2001 17:59:10 -0400

It's funny you write that because I made a complete fool of myself the first
week of my new tech writing job when I said, "Hey, can we put a glossary in
here?" Both of the senior writers looked at me like 1) I'd lost my mind, and
2) they were trying not to burst out laughing. Whenever I make a similarly
overly ambitious suggestion, they remark, "Yeah, just like that glossary you
were gonna do." :-)
In my defense, I did get two "Definition of terms" sections in at the
beginning of two chapters. Now, THAT would be a really long story...
Jessica Nealon
"CHRISTINE ANAMEIER" <CANAMEIE -at- email -dot- usps -dot- gov
<mailto:CANAMEIE -at- email -dot- usps -dot- gov>> wrote in message <news:126195 -at- techwr-l>...

It's hard
enough to get users to read a manual, much less the glossary of a
manual--especially if the user's in the middle of a task and they're
looking for help. Their reaction to an unfamiliar term like "radio
button" won't be "I'd better brush up on my terminology; where's the
glossary..."--it'll be "Why can't they write this #$^&* thing in


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.


Previous by Author: RE: Most Impt. Skill to Learn in Tech Comm Program?
Next by Author: Glossary
Previous by Thread: Re: Word 2000, Acrobat 4.0, and page breaks
Next by Thread: Re: Glossary

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

Sponsored Ads