[OpenStack-docs] RST include files - proposal forward

Andreas Jaeger aj at suse.com
Sat Jul 11 17:56:13 UTC 2015


So far, we have included RST files with
:include: some-file.rst

and then added the file to a hidden toctree.

I propose - as mentioned by somebody else previously - to use the 
following practice:

* include files end with .txt

That's all. Since sphinx ignores .txt files, we do not need to add any 
hidden toctree at all...

Any better ideas? Otherwise I add this to our wiki...

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, Dilip Upmanyu, Graham Norton,
        HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126




More information about the OpenStack-docs mailing list