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
Barnes&Noble.com
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
"Run".
>>
>
> >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?)
>
