Re: [openstack-dev] [docs] [api] Oh Swagger, where art thou?

2016-04-01 Thread Jim Rollenhagen
On Fri, Apr 01, 2016 at 10:13:49AM -0500, Anne Gentle wrote: > On Thu, Mar 31, 2016 at 11:22 AM, Jim Rollenhagen > wrote: > > > On Thu, Mar 31, 2016 at 09:50:48AM -0400, Sean Dague wrote: > > > On 03/31/2016 09:43 AM, Jim Rollenhagen wrote: > > > > On Thu, Mar 31, 2016

Re: [openstack-dev] [docs] [api] Oh Swagger, where art thou?

2016-04-01 Thread Anne Gentle
On Thu, Mar 31, 2016 at 11:22 AM, Jim Rollenhagen wrote: > On Thu, Mar 31, 2016 at 09:50:48AM -0400, Sean Dague wrote: > > On 03/31/2016 09:43 AM, Jim Rollenhagen wrote: > > > On Thu, Mar 31, 2016 at 08:43:29AM -0400, Sean Dague wrote: > > >> Some more details on

Re: [openstack-dev] [docs] [api] Oh Swagger, where art thou?

2016-03-31 Thread Jim Rollenhagen
On Thu, Mar 31, 2016 at 09:50:48AM -0400, Sean Dague wrote: > On 03/31/2016 09:43 AM, Jim Rollenhagen wrote: > > On Thu, Mar 31, 2016 at 08:43:29AM -0400, Sean Dague wrote: > >> Some more details on progress, because this is getting closer every day. > >> > >> There is now an api-ref target on the

Re: [openstack-dev] [docs] [api] Oh Swagger, where art thou?

2016-03-31 Thread Sean Dague
On 03/31/2016 09:43 AM, Jim Rollenhagen wrote: > On Thu, Mar 31, 2016 at 08:43:29AM -0400, Sean Dague wrote: >> Some more details on progress, because this is getting closer every day. >> >> There is now an api-ref target on the Nova project. The entire work in >> progress stream has been rebased

Re: [openstack-dev] [docs] [api] Oh Swagger, where art thou?

2016-03-31 Thread Jim Rollenhagen
On Thu, Mar 31, 2016 at 08:43:29AM -0400, Sean Dague wrote: > Some more details on progress, because this is getting closer every day. > > There is now an api-ref target on the Nova project. The entire work in > progress stream has been rebased into 2 patches to a top level api-ref/ > directory

Re: [openstack-dev] [docs] [api] Oh Swagger, where art thou?

2016-03-29 Thread Sean Dague
Some additional links to what this sort of looks like right now - http://docs-draft.openstack.org/71/298671/1/check/gate-nova-docs/c9e7f66//doc/build/html/rest_api/ Which is built off an RST file that looks like - http://tinyurl.com/hjqpjdm The notable additions are the ".. rest_method::"

[openstack-dev] [docs] [api] Oh Swagger, where art thou?

2016-03-28 Thread Anne Gentle
Hi all, This release I’ve been communicating about moving from WADL to Swagger for the API reference information on developer.openstack.org. What we've discovered on the journey is that Swagger doesn't match well for our current API designs (details below), and while we're not completely giving