Re: Consistent Index Entries

Subject: Re: Consistent Index Entries
From: Lori Lathrop <76620 -dot- 456 -at- COMPUSERVE -dot- COM>
Date: Fri, 21 Apr 1995 19:42:00 EDT

Paul -- If there are just a few page references, the best solution is to
provide page refs after *both* the acronym (with spelled-out term in
parentheses) and the spelled-out term (with acronym in parentheses). For
example:

Simple Network Management Protocol (SNMP) 145, 268

and

SNMP (Simple Network Management Protocol) 145, 268

However, if you have several subentries, you should put them under the
whichever is the better-known term. For example, if your audience would
be more familiar with "SNMP" than with "Simple Network Management
Protocol," then the subentries should be under "SNMP (Simple Network
Management Protocol" and you should provide a *See* reference for the
spelled-out version:

SNMP (Simple Network Management Protocol)
first subentry
second subentry
third subentry
zee last subentry :-)

and

Simple Network Management Protocol
*See* SNMP (Simple Network Management Protocol)

On the other hand, if your audience is *not* likely to be familiar with
either the acronym (example: "VB") or the spelled-out version ("View
Builder") and, if we can assume that there are several subentries for
that topic, you should put the subentries under the spelled-out version:

VB
*See* View Builder

and

View Builder (VB)
first subentry
second subentry
third subentry

*See* references point readers to the *preferred* term. When you index
terms in this way, your index becomes a learning tool for readers who may
not be familiar with product terminology.

Hope this helps ....

Lori Lathrop

************************************************************************
Lori Lathrop ----------> INTERNET:76620 -dot- 456 -at- compuserve -dot- com
Lathrop Media Services, P.O. Box 808, Georgetown, CO 80444
************************************************************************


Previous by Author: Re: Macs vs Pcs
Next by Author: Re: Product Packaging: [Humor]
Previous by Thread: SME vs Tech Writer WRT ISO 9000
Next by Thread: WWW pages


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

Sponsored Ads


Sponsored Ads