[OpenStack-Infra] Style Guide for Infra Manual

Andreas Jaeger aj at suse.com
Sun Jul 27 18:33:55 UTC 2014


On 07/22/2014 08:29 AM, Andreas Jaeger wrote:
> 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,

I've done the split-up now so that it can be consumed by others as well,

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: 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