Re: Index/TOC Needed in HTML &/or Browser-Based Help?
I have had users here who ask for an "index", that is, keyword search,
rather than text search.
I see several streams of inquiry related to this:
* User expectations - Does it confuse users if a TOC and index are
* User modeling/research - Are we convinced that users only need a
* Tech writing expectations - Are we as tech writers uncomfortable with
removing TOCs and indexes? Is this
based on experience, or fear of change?
* Technology - Are our search tools sufficient to achieve customer
A few points about about indexing vs. text search:
* Full text searches depend on what the author includes in the
document (I remember an STC presentation by Jared Spool a couple
of years ago in which he said a search of Smithsonian Magazine
archives for "dinosaur" turned up an article on the American steel
industry but not one on tyrannasaurus rex).
* You can provide alternate industry terms in an index but not
a text search (for example, if you use "Contacts" rather than
"Addresses" for an address book)
* An index can indicate the significance of a topic by
where the entry is grouped in a sequence
* An index can provide other related topics using "see also"
Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address
Tact is for people who aren't witty enough to be sarcastic
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
Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.DocToHelp.com/TechwrlList
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com
To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.
RE: Index/TOC Needed in HTML &/or Browser-Based Help?: From: Joe Malin
Previous by Author:
Re: Documentation Architect...is there really such a creature?
Next by Author: Re: Multiple Index Entries: Your Input, Please...
Previous by Thread: RE: Index/TOC Needed in HTML &/or Browser-Based Help?
Next by Thread: RE: Index/TOC Needed in HTML &/or Browser-Based Help?
Search our Technical Writing Archives & Magazine