[OpenStack-Infra] Style Guide for Infra Manual

Andreas Jaeger aj at suse.com
Tue Jul 22 06:29:13 UTC 2014


On 07/21/2014 10:30 PM, Anita Kuno wrote:
> Currently infra-manual doesn't have a style guide. We need one.
> 
> There was some great work done at the QA/Infra meetup on infra-manual.
> Pavel was offering some style markup for the infra-manual, but since we
> don't have a style guide yet, it is difficult to get consistency with
> the markup.
> 
> Let's collect our thoughts about how we would like style to be used in
> the infra-manual. We can then create a style-guide file inside the repo
> to direct future patches and reviews.
> 
> Who has some thoughts on this?

I suggest to follow the conventions that the Doc team is using:

https://wiki.openstack.org/wiki/Documentation/Conventions

If it helps, we can easily split this up so that we can both use it,

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126



More information about the OpenStack-Infra mailing list