Affects: Documentation (Ref Guide, User Guide, etc.)
project_key: SOA

I've realized our documentation is inferior to third party resources (i.e. 'JBoss in Action', 'JBoss at Work', etc.) in an important aspect.  Third party books provide a glossary at the end of the document that can be used to look up a topic of interest.  (i.e. 'transaction', 'connection factory', etc.)  Our documentation has no such index, the user has to open each of the documents individually and use a search feature to locate topic references.

This is not as handy, because the user has no way of knowing how many references they'll need to page through, and is unable to quickly jump to the desired one.  If a glossary is present, often times the user can judge which instance to use based on proximity to other instances.  (i.e. a single lone instance on page 16 is probably a high-level introduction, but if you see a cluster on pages 456, 458 and 459 you know the topic is being discussed in detail there.)

Please consider providing a glossary in our documentation.

Thanks!