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.
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?)
>
