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

Joshua Hesketh joshua.hesketh at gmail.com
Sat Feb 13 02:06:08 UTC 2016


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 13, 2016 at 12:43 PM, michael mccune <msm at redhat.com> wrote:

> On 02/12/2016 04:45 PM, Anne Gentle wrote:
> <snip>
>
>> 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
>> developer.openstack.org/draft/swagger
>> <http://developer.openstack.org/draft/swagger>.
>>
>> We know that not all files migrate smoothly. We'd love to get teams
>> looking at these migrated files. Thank you to those of you already
>> submitting fixes!
>>
>> In addition, the infra team is reviewing a spec now so that we can serve
>> API reference information from the developer.openstack.org
>> <http://developer.openstack.org> site:
>> https://review.openstack.org/#/c/276484/
>>
>>
> Anne, this is a great update!
>
> love to see the progress on swagger integration.
>
>
> <snip>
>
>> Last but not least, if you want to learn more about Swagger in the
>> upstream contributors track at the Summit, vote for this session:
>>
>> https://www.openstack.org/summit/austin-2016/vote-for-speakers/presentation/7723
>>
>
> sweet, +1
>
> regards,
> mike
>
>
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160213/7173908f/attachment.html>


More information about the OpenStack-dev mailing list