Re: [openstack-dev] [docs] [api] Why WADL when you can Swagger

2016-03-10 Thread Anne Gentle
On Thu, Mar 10, 2016 at 8:03 AM, Sean Dague wrote: > Ok, I'm responding very late to this thread because other bits of the > release cycle had attention. > > A couple of questions. > > 1) why are we using the JSON version of the specification instead of the > YAML one - > >

Re: [openstack-dev] [docs] [api] Why WADL when you can Swagger

2016-03-10 Thread Sean Dague
Ok, I'm responding very late to this thread because other bits of the release cycle had attention. A couple of questions. 1) why are we using the JSON version of the specification instead of the YAML one - https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#format One of

[openstack-dev] [docs] [api] Why WADL when you can Swagger

2016-02-12 Thread Anne Gentle
Hi all, I wanted to give an update on the efforts to provide improved application developer information on developer.openstack.org. Wrangling this much valuable information and gathering it in a way that helps people is no simple matter. So. We move forward one step at a time. What's new?

Re: [openstack-dev] [docs] [api] Why WADL when you can Swagger

2016-02-12 Thread michael mccune
On 02/12/2016 04:45 PM, Anne Gentle wrote: What's new? This week, with every build of the api-site, we are now running fairy-slipper to migrate from WADL to Swagger for API reference information. Those migrated Swagger files are then copied to

Re: [openstack-dev] [docs] [api] Why WADL when you can Swagger

2016-02-12 Thread Monty Taylor
On 02/12/2016 03:45 PM, Anne Gentle wrote: Hi all, I wanted to give an update on the efforts to provide improved application developer information on developer.openstack.org . Wrangling this much valuable information and gathering it in a way that helps people is

Re: [openstack-dev] [docs] [api] Why WADL when you can Swagger

2016-02-12 Thread Joshua Hesketh
Hey Anne, Thanks for all your work. This sounds really exciting. The explanation in this email was largely what I was missing during my earlier reviews of the spec. I'll take another look at the spec shortly but it might be helpful to have some of this rationale added. Cheers, Josh On Sat, Feb