[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>
wrote:

> 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:

https://wiki.openstack.org/wiki/Meetings/CrossProjectMeeting#Proposed_agenda



>
> 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
Rackspace
Principal Engineer
www.justwriteclick.com
-------------- 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