Glossary in webhelp and print docs

Subject: Glossary in webhelp and print docs
From: Viv Crawford <viv_crawford -at- hotmail -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 13 Jul 2010 16:51:38 +0100


I'm creating a glossary that will be part of a webhelp.

I'm using Flare to create it, though IIRC, Robohelp works in the same way.

In the webhelp, the glossary will appear in the left hand panel. There will be a list of terms. I can choose whether the definitions should appear in the glossary panel alongside the term or in a separate topic. And I can't decide which is better.

I think that having the definition next to the term will display more quickly than opening a new topic. However, putting the terms in a separate topic will allow me to use cross-references to other terms and topics. I haven't written the definitions yet, so I can write them to include x-refs or not.

Have any of you any thoughts? Examples? Other pros and cons of each approach? What have I not thought of?



Do you have a story that started on Hotmail? Tell us now

Gain access to everything you need to create and publish information
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days.

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.

Please move off-topic discussions to the Chat list, at:

Previous by Author: RE: Create PDFs from Word docs using command line?
Next by Author: RE: Certification: Ernest and Scribbler
Previous by Thread: RE: Word "Final" versus pdf
Next by Thread: (C'mon Now, Organ)...Do the "Tighten Up"

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

Sponsored Ads