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.
My standard is to use nouns as index terms, and with two forms that act
as nouns, I prefer the real one over the grammatical one. So Index entry
No. 1 is what I would use.
This is based on the idea that an index that uses
Users
adding
is more granular than
Adding
users
This is a standard I learned on the job. I don't know if it has any
basis in usability research.
I wouldn't include both forms. My expectation is that most users will
look through the index and figure out how it's organized. If the style
of Users > adding is consistently used, the reader will know how to look
up most information.
And, as you say, users is more specific than adding.
Joe Malin
Technical Writer
(408)625-1623
jmalin -at- tuvox -dot- com
www.tuvox.com
The views expressed in this document are those of the sender, and do not
necessarily reflect those of TuVox, Inc.
-----Original Message-----
From: techwr-l-bounces+jmalin=tuvox -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+jmalin=tuvox -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf
Of Keith Hansen
Sent: Tuesday, May 23, 2006 12:53 PM
To: TECHWR-L
Subject: Multiple Index Entries: Your Input, Please...
Hello all!
I have an indexing question; please give me your opinion.
In many cases, it's possible to have two (or more) index entries that
refer you to the same page. Example:
* Index Entry No. 1: Users, adding to system . . . p. 264
* Index Entry No. 2: Adding users to system . . . p. 264
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l