Open Stack

On 04/12/2015 10:09 AM, Andreas Jaeger wrote:
> Sphinx with RST easily handles a glossary and I suggest the following:
>
> We convert the glossary to RST and then include it as appropriate in our
> RST guides.
>
> The glossary continues to exist as both DocBook XML and RST files, any
> changes done to one version need to be added to the other one as well.
>
> Reasoning: An automatic conversion from one format into the other is
> difficult and error prone, we would lose formatting. The glossary
> changes seldom enough that duplication is not a major burden.
>
> If anybody comes up with a create format conversion that keeps
> directives, we can always change...
>
>
> Does this work for you?
>
> If it does, I'll start working on the RST glossary,

I've got another idea, let me implement and check whether it works - and 
then perhaps make a better proposal,

Andreas
-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,
        Graham Norton, HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126