HTML Guides

Subject: HTML Guides
From: Heidi Colonna <mahalapoo_cliff -at- yahoo -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 7 Apr 2006 14:43:41 -0700 (PDT)

Our shop is planning (in the near future) on moving from .pdf guides, mostly user guides, to HTML user guides. In doing some research online, it appears that HTML guides are not all that different from online help systems as far as the chunking of information/topics. The only major difference I've noticed is that in help systems you have a TOC and in an HTML guide you have a list of links.

Some of our guides use information mapping (IM) procedures. In playing with the HTML output of guides with these IM tables, the information mapping tables are lengthy and look bad.

My sense is that as we move to HTML, in our documentation that uses the IM method is going to have to be changed.

Has anyone ever seen or heard pros/cons on using IM tables in HTML guides?

Does anyone know of any good resources/best practices for HTML guides?

Your feedback is appreciated.


Yahoo! Messenger with Voice. Make PC-to-Phone Calls to the US (and 30+ countries) for 2¢/min or less.

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!.

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

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

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 for more resources and info.


Previous by Author: Microsoft's plans for Vista Help
Next by Author: Re: The Problem With Keeping It Plain And Simple
Previous by Thread: Re: Fwd: UK/US usage: V ac, VAC?
Next by Thread: HTML Guides?

What this post helpful? Share it with friends and colleagues:

Sponsored Ads