RE: DocBooks question

Subject: RE: DocBooks question
From: "Hickling, Lisa (TOR)" <lhickling -at- Express-Scripts -dot- com>
To: rick -at- rlcdata -dot- com, "techwr-l" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 23 Aug 2007 14:42:01 -0400

Hello Rick,

Welcome! I sense some underlying developer cum writer angst in
the issues you have raised? If so, I empathize having been there and
formerly worn the t-shirt. Helpful tip: keep an open mind when asking
for help on this list. The responses so far have pointed you to a
possibility that Docbook is the least of your worries at this point.

You have striven to be innovative and created your own help tool.
Honestly, this is very good but potentially a bad thing. While you have
a completely custom help application, now you have the challenge of
retrofitting it for indexing and searching capabilities. This is, in
effect, an exercise in wheel reinvention given the abundant availability
of HATs, as someone already pointed out. Possible solution: Use the site to select the HAT that best suits your requirements
(including DocBook support) and budget, upload your html pages to it,
build your index and depend on the tool's capabilities to deliver your

Regarding DocBook, it is admirable that you want your content to adhere
to an establish standard from the outset. Consider familiarizing
yourself with its tenets and applying its standards to elements of your
docs as part of your style guide. Your docset will then be well equipped
for integration into a XML solution when your other issues are solved
and implementation is appropriate.

Best wishes on your project!

Lisa H.
GTA, Ontario

******* Confidentiality Notice *******
ESI Canada -- Optimizing the value of drug and dental benefits

This email, its electronic document attachments, and the contents of its website linkages may contain confidential health information. This information is intended solely for use by the individual or entity to whom it is addressed. If you have received this information in error, please notify the sender immediately and arrange for the prompt destruction of the material and any accompanying attachments.

******* Avis de confidentialite *******
ESI Canada -- Optimiser la valeur des regimes d'assurance medicaments et dentaires

Ce courriel ainsi que tout document y etant joint de meme que le contenu des liens vers des sites Web peuvent reunir des renseignements confidentiels sur la sante. Cette information s'adresse uniquement a l'usager ou a l'organisation auxquels elle est destinee. Si vous avez recu ce message par erreur, veuillez en aviser l'expediteur immediatement et proceder a la suppression du document et des fichiers joints sans tarder.


Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -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 admin -at- techwr-l -dot- com -dot- Visit for more resources and info.


Re: DocBooks question: From: Rick Copple

Previous by Author: Re: What do you call your examples?
Next by Author: RE: Checking for updated documentation
Previous by Thread: Re: DocBooks question
Next by Thread: RE: DocBooks question

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

Sponsored Ads