Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-08 Thread Mathieu Rohon
Hi all, thanks for the explanation. Can you also explain how does neutron team use blueprints? how it overlaps with RFE bugs? On Mon, Dec 7, 2015 at 6:40 PM, Sean M. Collins wrote: > On Mon, Dec 07, 2015 at 12:18:29PM EST, Carl Baldwin wrote: > > On Fri, Dec 4, 2015 at

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-08 Thread Neil Jerram
On 08/12/15 10:04, Mathieu Rohon wrote: Hi all, thanks for the explanation. Can you also explain how does neutron team use blueprints? how it overlaps with RFE bugs? Hi Mathieu, This is all documented, in principle, at http://docs.openstack.org/developer/neutron/policies/blueprints.html.

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-08 Thread Neil Jerram
On 07/12/15 17:42, Sean M. Collins wrote: > On Mon, Dec 07, 2015 at 12:18:29PM EST, Carl Baldwin wrote: >> On Fri, Dec 4, 2015 at 12:22 PM, Henry Gessau wrote: >>> 1. RFE: "I want X" >>> 2. Spec: "I plan to implement X like this" >>> 3. devref: "How X is implemented and how to

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-08 Thread Mike Spreitzer
> From: Henry Gessau <ges...@gmail.com> > To: "OpenStack Development Mailing List (not for usage questions)" > <openstack-dev@lists.openstack.org> > Date: 12/04/2015 02:23 PM > Subject: Re: [openstack-dev] [neutron] Multiple locations for > documenta

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-08 Thread Sean M. Collins
On Tue, Dec 08, 2015 at 09:03:10AM EST, Mike Spreitzer wrote: > Lots cheers from me too. Let me add one thing: "the spec is not > maintained" is a remaining process bug. A spec by itself is a very useful > thing. It is the first thing to read when trying to understand the > implementation.

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-07 Thread Sean M. Collins
On Mon, Dec 07, 2015 at 12:18:29PM EST, Carl Baldwin wrote: > On Fri, Dec 4, 2015 at 12:22 PM, Henry Gessau wrote: > > 1. RFE: "I want X" > > 2. Spec: "I plan to implement X like this" > > 3. devref: "How X is implemented and how to extend it" > > 4. OS docs: "API and guide for

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-07 Thread Carl Baldwin
On Fri, Dec 4, 2015 at 12:22 PM, Henry Gessau wrote: > 1. RFE: "I want X" > 2. Spec: "I plan to implement X like this" > 3. devref: "How X is implemented and how to extend it" > 4. OS docs: "API and guide for using X" > > Once X is implemented I don't want to have to go to 1 or

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-07 Thread Neil Jerram
On 04/12/15 19:24, Henry Gessau wrote: > Sean M. Collins wrote: >> I've noticed that a lot of features are now being documented as RSTs >> inside of devref. Like the following: >> >> https://review.openstack.org/#/c/251859/ >> >> But there are lots already present. Can someone

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-04 Thread Armando M.
On 4 December 2015 at 11:22, Henry Gessau wrote: > Sean M. Collins wrote: > > I've noticed that a lot of features are now being documented as RSTs > > inside of devref. Like the following: > > > > https://review.openstack.org/#/c/251859/ > > > > But there

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-04 Thread Akihiro Motoki
2015-12-05 8:40 GMT+09:00 Armando M. : > > > On 4 December 2015 at 11:22, Henry Gessau wrote: >> >> Sean M. Collins wrote: >> > I've noticed that a lot of features are now being documented as RSTs >> > inside of devref. Like the following:

Re: [openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-04 Thread Henry Gessau
Sean M. Collins wrote: > I've noticed that a lot of features are now being documented as RSTs > inside of devref. Like the following: > > https://review.openstack.org/#/c/251859/ > > But there are lots already present. Can someone point out to me what the > criteria is for

[openstack-dev] [neutron] Multiple locations for documentation of features

2015-12-03 Thread Sean M. Collins
Hi, I've noticed that a lot of features are now being documented as RSTs inside of devref. Like the following: https://review.openstack.org/#/c/251859/ But there are lots already present. Can someone point out to me what the criteria is for these documents? I am a little confused about the