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: Should a glossary be indexed? From:"Chuck Martin" <cm -at- writeforyou -dot- com> To:techwr-l Date:Mon, 1 Mar 2004 15:52:39 -0800
"Jan Henning" <henning -at- r-l -dot- de> wrote in message news:230646 -at- techwr-l -dot- -dot- -dot-
> > It seems to me that the answer would be no, but I came across one
> > today so thought I might pose the question to the community at large.
> Yes, every glossary term should be in the index, for a simple reason:
> If you do not index the glossary, you force the reader to look in two
> places. If you index it, the reader need only look in the index.
OK, I don't understand this point of view. It seems to me that if you do put
a glossary term in the index, than the reader is looking in 2 places: the
index, then the glossary.
An index is an entry point into a book, a main one. When readers look for
information, they depend on an index to show them where they can find that
information. While glossaries are information, they are like a mini
dictionary, defining terms in order in one concentrated section. I'd think
that if readers want a term defined, they will go directly to the glossary
and bypass the index entirely.
Plus, readers aren't likely to be using the glossary on entry to the book.
Rather, they are already in the book reading and come upon an unfamiliar
term. If that book has a glossary, it's commonly at the end, just before the
index, and so readers go directly there looking.
I think the only time you'd put glossary terms in the index is if you're
defining terms within or beside the text. Many books define terms in the
margins when the terms are first used, and in that case I'd add index
entries that look like this:
If the book also collects all those definintions in a glossary, I'm not sure
if I'd make 2 page entries.
User Assistance & Experience Engineer
twriter "at" sonic "dot" net www.writeforyou.com
"I see in your eyes the same fear that would take the heart of me. The day
may come when the courage of Men fail, when we forsake our friends and
break all bonds of fellowship. But it is not this day! This day, we fight!"
"All you have to decide is what to do with the time that is given you."