Re: Index/TOC Needed in HTML &/or Browser-Based Help? (take II)
Taxonomies are also designed by the author, and thus have the potential to be equally arbitrary. To work well, both require audience-centered design: you can't impose an effective structure or even a taxonomy if you don't think of the information from the user's perspective. That insight into the user is what makes a TOC effective. Its absence is what undermines a TOC, and what will undermine taxonomies too. ...--
That being the case, *why muck with what works*? Call it a table of contents, and provide tools that facilitate the grouping of information into appropriate categories ("taxonomies").
<<And there wasn't an index tab. However, one of the MAML elements was for keywords, and these keywords would be used to beef up the search. There were also features like "Best Bet Keyword", which would push a topic toward the top of a search list.>>
Really. Dumb. Decision. Indexes work well because they organize information conceptually and by context. A good index provides entries such as "Print: troubleshooting font problems" beside "Print: configuring a printer" so you can compare the two entries and guess which one is most likely to answer questions. The keywords themselves are merely the superficial evidence of the thought process that went into defining and presenting these alternatives.
Search engines cannot provide that context unless it's designed into the text being searched; the keywords must not only be present, but there must be meta-information that accompanies them to provide the context for the keyword. Currently, that is the single biggest flaw in all the search engines I've used. Defining better keywords won't by itself help improve searches: the same time required to choose and test keywords would be better spent creating an index.
If you know anyone involved in the design aspect of this part of the project, please pass that distinction along. It's not trivial, and it's very important to users.
Professor, Technical Communication
Seneca College of Applied Arts & Technology
Toronto, ON 416.491.5050 x3133
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.
Index/TOC Needed in HTML &/or Browser-Based Help?: From: Barbara Vega
Index/TOC Needed in HTML &/or Browser-Based Help?: From: Geoff Hart
Re: Index/TOC Needed in HTML &/or Browser-Based Help?: From: Char James-Tanny
Index/TOC Needed in HTML &/or Browser-Based Help? (take II): From: Geoff Hart
Previous by Author:
RE: Moving upstream
Next by Author: Taxonomy (was Re: Index/TOC Needed in HTML &/or Browser-Based Help?)
Previous by Thread: Re: Index/TOC Needed in HTML &/or Browser-Based Help? (take II)
Next by Thread: Re: Index/TOC Needed in HTML &/or Browser-Based Help? (take II)
Search our Technical Writing Archives & Magazine