[OpenStack-docs] Writing RST Conventions

Andreas Jaeger aj at suse.com
Sat Nov 8 18:51:58 UTC 2014


As discussed on Friday at the Docpod, I'd like to add RST conventions so
that they can be used by others, for example infra-manual.

Looking at
https://wiki.openstack.org/wiki/Documentation/Docbook_conventions I
propose to rename the page from "Docbook conventions" to "Markup
conventions" and add for each Docbook example a corresponding RST example.
I prefer this option (having Docbook and RST on the same page) since
that also helps with moving from one to the other.

Alternative would be a complete new page.

Anybody with objections with moving forward with a single page?

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF:Jeff Hawn,Jennifer Guild,Felix Imendörffer,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