[OpenStack-docs] Reviewed page for Conventions and Style guide?

Anne Gentle anne at openstack.org
Sun Nov 9 12:17:15 UTC 2014


On Sun, Nov 9, 2014 at 3:23 AM, Andreas Jaeger <aj at suse.com> wrote:

> On 11/08/2014 10:40 PM, Matt Kassawara wrote:
> > [...]
> > As for the format, I prefer something more topic-happy and less
> > encumbered... perhaps markdown, RST, or asciidoc.
>
> I think RST is the only alternative to DocBook since the rest of
> OpenStack has basically standarized on RST - together with sphinx and
> the oslosphinx extension. I wouldn't go to markdown or asciidoc,
>

Yeah, that decision was the result of our discussions last week.
Individuals aren't opposed to markdown, but the general consensus was that
RST/Sphinx is in place already and supported tooling.


>
> 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
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20141109/4c650212/attachment.html>


More information about the OpenStack-docs mailing list