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: Where does the glossary belong? From:Suzanne Lee <suzanne -at- AUTOSIM -dot- COM> Date:Wed, 29 Mar 1995 11:13:58 -0700
Chani Sacharen asks about glossaries:
>(snip)
Here are my alternatives:
>2. Keep a small version of the glossary in the first chapter. This would
>include terms that I feel must be defined early on (like browser, activity..)
>and put the entire glossary in an Appendix.
I would choose this one. When I'm using a manual and want to look up a
term, I expect the glossary to be at the back of the book. I agree that
it's hard when you need to introduce certain terms early on, but I'd say,
define them the first place they're used, and reference them in the
glossary. I think this is pretty standard. It allows people who know the
term to avoid unnecessary info, but allows rookies to learn.
***************************************************************************
from Suzanne Lee - suzanne -at- autosim -dot- com
AutoSimulations, Inc. - Bountiful, UT
(801)298-1398 ext 333 fax (801)298-8186
***************************************************************************
