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

Anne Gentle annegentle at justwriteclick.com
Mon Jan 11 16:23:24 UTC 2016


On Fri, Jan 8, 2016 at 7:35 PM, Anne Gentle <annegentle at justwriteclick.com>
wrote:

>
>
> 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
>>
>
>
Double whoops, I mean Tuesday at 2100.
Anne


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



-- 
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160111/787ef2ac/attachment.html>


More information about the OpenStack-dev mailing list