Inclusion of Field Descriptions in Help Systems

[David Goldberg <david -dot- goldberg -at- jda -dot- com>]

I would like to know how others handle the definition of fields in
non-context sensitive Help systems for large software applications,
particularly using the RoboHTML and WebHelp products. 

Do you put all application field definitions in a common glossary and link
to the glossary from the procedural topics?  Do you have separate field
description topics per application screen and list the definitions there?
Do you use techniques like text-only popups to display the field definitions
without having the user leave the procedural topic?

All these techniques have pros and cons. I have yet to identify an optimal
solution. Your feedback is welcome. Thank you.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you 
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of 
your book. What are you waiting for? http://www.iuniverse.com/media/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit 
http://www.raycomm.com/techwhirl/ for more resources and info.