RE: Testing an index

Subject: RE: Testing an index
From: "Marguerite Krupp (mkrupp)" <mkrupp -at- cisco -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 25 Feb 2008 10:38:05 -0500

Perhaps I'm flogging a dead horse here, but I think that "See" and "See
also" references are amont the things that help differentiate a real
index from a full-text search.

In general, I use "See" references to establish a link between synonyms,
especially where the entries (almost?) all appear under one entry, but
users might use a different term to refer to the same thing. The lack of
synonyms in a lot of Microsoft's documentation has caused me to use a
lot of immoderate language!

I use "See also" references to point to related, but not synonymous
topics; for example, "Conference call, see also collaboration, online."


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.


Previous by Author: Instructor's and student's manual in one
Next by Author: RE: Testing an index
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