[openstack-dev] [doc] [api] Vision and changes for OpenStack API Guides

Anne Gentle annegentle at justwriteclick.com
Sat Jan 9 01:35:31 UTC 2016

On Fri, Jan 8, 2016 at 3:39 PM, Anne Gentle <annegentle at justwriteclick.com>

> Hi all,
> With milestone 2 coming next week I want to have a chat about API guides,
> API reference information, and the http://developer.openstack.org site.
> We have a new tool, fairy-slipper [1], yep you read that right, that can
> migrate files from WADL to Swagger as well as serve up reference info. We
> also have new build jobs that can build API guides right from your projects
> repo to developer.openstack.org.
> There's a lot going on, so I've got an agenda item for next week to hold a
> cross-project meeting so that you can send a team representative to get the
> scoop on API guides and bring it back to your teams. I've fielded great
> questions from a few teams, and want to ensure everyone's in the loop.
> A pair of specs set the stage for this work, feel free to review these in
> advance of the meeting and come with questions. [2] [3]
> Join me next week at the first pop-up Cross Project meeting, Tuesday at
> 1700, in #openstack-meeting-cp. Feel free to add to the agenda at

Woops, agenda here:


> Thanks,
> Anne
> 1. https://github.com/openstack/fairy-slipper
> 2. mitaka spec:
> http://specs.openstack.org/openstack/docs-specs/specs/mitaka/app-guides-mitaka-vision.html
> 3. liberty spec:
> http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html
> --
> Anne Gentle
> Rackspace
> Principal Engineer
> www.justwriteclick.com

Anne Gentle
Principal Engineer
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160108/36701940/attachment.html>

More information about the OpenStack-dev mailing list