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

Anne Gentle annegentle at justwriteclick.com
Fri Jan 8 21:39:07 UTC 2016


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

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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20160108/60ba0f3a/attachment.html>


More information about the OpenStack-docs mailing list