RE: RE: Indexing style refs

Subject: RE: RE: Indexing style refs
From: John Posada <JPosada -at- book -dot- com>
To: "'Susan W. Gallagher'" <sgallagher5 -at- cox -dot- net>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 5 Aug 2003 14:14:45 -0400

You cannot accommodate every user however they want. At a certain point, you
must say no. If my user gets upset because I haven't put "way cook button"
in the index, or if I include 20 synonyms and they can't find it because I
didn't include the 21st one, I say tough. We're here to create solid,
accurate documentation, not to bow to every off-the-wall whim of everyone on
the face of the earth.

The customer is the customer and the customer ISN'T always right.

John Posada
Information Hunter-Gatherer
Special Projects; Information Technology
NY: 212-414-6656

> itself, but in a user-friendly index, synonyms
> are essential, and the more the merrier.
> my two cents. ;-)

>> I think the purpose of the controlled list is to eliminate the need to
>> include terms such as "way cool button" in the index as a synonym for
> >Isn't the purpose of an index to provide synonyms? 20
> >people reading documentation will think of 20 different
> >words for the same concept when they consult the index.
> >(Or am I missing the point?)


Previous by Author: RE: Indexing style refs
Next by Author: RE: Effective Arguments for Unique Control Names...?
Previous by Thread: Re: RE: Indexing style refs
Next by Thread: Re: Indexing style refs

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

Sponsored Ads