RE: Testing an index

Subject: RE: Testing an index
From: Fred Ridder <docudoc -at- hotmail -dot- com>
To: Peter Neilson <neilson -at- windstream -dot- net>, Wanda Phillips <wanda -dot- jane -at- gmail -dot- com>
Date: Sat, 23 Feb 2008 09:57:37 -0500

Responding to Wanda Phillips, Peter Neilson wrote (in part):
> Although entries that tell the reader to "See also" are occasionally
> helpful, the entry that says, "See" rarely is. "Baked beans, see Beans,
> baked" could have just as easily said, "Baked beans, 162."

Where "See..." entries *are* useful is to identify a more fundamental
difference in terminology or to offer a close alternative.

To continue with Peter's example, your cookbook index might include
an entry "Boston baked beans, see Beans, baked" or "Cassoulet, see
Beans, baked" if there is some discussion of baked bean dishes that
mentions those specific preparations without actually giving recipes.
In this case, the "see" entry provides a clue that the reference is
not an exact match for the topic the reader is looking for.

Or your cookbook index might include an entry like "Legumes, see
Beans" if all your entries for legume recipes are indexed as bean
recipes. This is most appropriate where there are multiple entries
that use the different term you identify so that you really couldn't
pick just one to topic (recipe, in this case) to point to directly.
-Fred Ridder

Climb to the top of the charts! Play the word scramble challenge with star power.

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.


Testing an index: From: Wanda Phillips
Re: Testing an index: From: Peter Neilson

Previous by Author: RE: Upgrade to Frame 8
Next by Author: Re: Word Syles Automatic Update - should it be avoided?
Previous by Thread: Re: Testing an index
Next by Thread: RE: Testing an index

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

Sponsored Ads