Re: [OpenStack-Infra] Style Guide for Infra Manual

2014-07-30 Thread Elizabeth K. Joseph
On Sun, Jul 27, 2014 at 12:58 PM, Anita Kuno wrote: > We will have differences of opinion about how and where to use bold and > other kinds of style choices. I think it is best we get all the opinions > out in the open so we can then begin to discuss them one at a time and > craft the guidelines f

Re: [OpenStack-Infra] Style Guide for Infra Manual

2014-07-27 Thread Anita Kuno
t;> >> .. _general conventions: >> https://wiki.openstack.org/wiki/Documentation/Conventions >> .. _proposal patch: https://review.openstack.org/#/c/107360 >> .. _rendered as html: >> http://docs-draft.openstack.org/60/107360/3/check/gate-infra-manual-docs/db428f9/doc/bu

Re: [OpenStack-Infra] Style Guide for Infra Manual

2014-07-27 Thread Andreas Jaeger
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

Re: [OpenStack-Infra] Style Guide for Infra Manual

2014-07-22 Thread Andreas Jaeger
rg/wiki/Documentation/Conventions > .. _proposal patch: https://review.openstack.org/#/c/107360 > .. _rendered as html: > http://docs-draft.openstack.org/60/107360/3/check/gate-infra-manual-docs/db428f9/doc/build/html/developers.html#code-review > > - Original Message - >> From: &q

Re: [OpenStack-Infra] Style Guide for Infra Manual

2014-07-22 Thread Pavel Sedlak
/doc/build/html/developers.html#code-review - Original Message - > From: "Andreas Jaeger" > To: "Anita Kuno" , openstack-infra@lists.openstack.org, > "Anne Gentle" > Sent: Tuesday, July 22, 2014 8:29:13 AM > Subject: Re: [OpenStack-Infra] Style

Re: [OpenStack-Infra] Style Guide for Infra Manual

2014-07-21 Thread Andreas Jaeger
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 dif

[OpenStack-Infra] Style Guide for Infra Manual

2014-07-21 Thread Anita Kuno
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 co