GNOME Bugzilla – Bug 743671
Propose Glossary Appendix
Last modified: 2018-06-29 23:38:04 UTC
I propose incorporating the Glossary from the wiki (http://wiki.gnucash.org/wiki/Glossary) as Appendix A in the Guide and Tutorial. This will give users better access to definitions used in the Guide. Initial implementation will not include embedded links in the guide, but the expectation would be that they would. Other Appendices would be adjusted as appropriate.
Reading through Chapter 1, I see a reference to a Glossary in section 1.3, so this bug formalizes that intention. Adding the glossary as Appendix A will require changes to gnucash-guide.xml and addition of glossary.xml to the fileset.
I like the Idea. On the long term it would save time, because there will be only one place with definitions which again will reduce redundacies and inconsistencies. Docbook - the xml dialect used in the docs - knows the following elements: glossary - A glossary glossaryinfo[4.0] - Meta-information for a Glossary glossdef - A definition in a GlossEntry glossdiv - A division in a Glossary glossentry - An entry in a Glossary or GlossList glosslist - A wrapper for a set of GlossEntrys glosssee - A cross-reference from one GlossEntry to another glossseealso - A cross-reference from one GlossEntry to another glossterm - A glossary term See e.g. http://tdg.docbook.org/tdg/4.5/docbook.html Currently our docs are based on version 4.4. I had not the time to play with above elements. So I can not say how expensive it will be. http://wiki.gnucash.org/wiki/Glossary started as a partial translation of http://wiki.gnucash.org/wiki/De/Glossar which again is still incomplete. Perhaps with Google Translate you could understand it.
My theoretical workflow: 1. write it quickly down in the wiki, 2. place typographical elements to improve usability (locating, understanding, structure ...), 3. replace the wiki tags by docbook tags and commit it. So I would not drop the wiki page. Because it is mach quicker and easier to edit, it should represent the most recent version.
Glossary has been added to Guide.
GnuCash bug tracking has moved to a new Bugzilla host. This bug has been copied to https://bugs.gnucash.org/show_bug.cgi?id=743671. Please update any external references or bookmarks.