Re: Indexing style refs
In a modern world, where creating an index is just a clickety-boo away,
what is the advantage of having "Instrument container, see toolbox"
references, other than teaching readers that "Instrument container" and
"toolbox" are synonyms?
True, they've learned a new synonym, but then they have to look up the
information twice--is that good?
Only the first time, and that's the point of using cross-references to teach vocabulary. Once readers know the preferred term, they look for that (rather than their own term) on future visits to the index.
Also, when they see referrences to a toolbox in the text, they know what it's about.
P.S. Just a clickety-boo away? What does that mean?
HTML Indexer 4 is still the easiest way to create and maintain indexes for web sites, intranets, HTML Help, JavaHelp, and other HTML documents.
HTML Indexer 4 includes fully integrated cross-references, target frames and windows, multiple-file output, "one-step accept" of default entries, and more!
Search our Technical Writing Archives & Magazine