[openstack-dev] [docs] [api] Oh Swagger, where art thou?

Anne Gentle annegentle at justwriteclick.com
Fri Apr 1 15:13:49 UTC 2016


On Thu, Mar 31, 2016 at 11:22 AM, Jim Rollenhagen <jim at jimrollenhagen.com>
wrote:

> On Thu, Mar 31, 2016 at 09:50:48AM -0400, Sean Dague wrote:
> > On 03/31/2016 09:43 AM, Jim Rollenhagen wrote:
> > > On Thu, Mar 31, 2016 at 08:43:29AM -0400, Sean Dague wrote:
> > >> Some more details on progress, because this is getting closer every
> day.
> > >>
> > >> There is now an api-ref target on the Nova project. The entire work in
> > >> progress stream has been rebased into 2 patches to a top level
> api-ref/
> > >> directory structure in the Nova tree -
> > >>
> https://review.openstack.org/#/q/status:open+project:openstack/nova+branch:master+topic:wip_api_docs2
> > >>
> > >> That is a 2 patch series. The first is the infrastructure, the second
> is
> > >> the content for 2 resources (versions and servers). The rendered
> output
> > >> for this is at -
> > >>
> http://docs-draft.openstack.org/63/298763/4/check/gate-nova-api-ref/6983838//api-ref/build/html/
> > >> (you can also pull and build locally with tox -e api-ref)
> > >>
> > >> Karen, Auggy, and Anne continue to work on the wadl data translator
> > >> using the wadl2rst project and fairy-slipper to get various pieces of
> > >> the structured data over. Hopefully we'll see some of those translated
> > >> stacks rendering soon in patch sets.
> > >
> > > I assume at some point we'll be pulling the sphinx extension out to a
> > > separate project so that other projects can use this too? :)
> > >
> > > // jim
> >
> > Yes. I feel like it's probably a milestone 2 activity. Fixing styling
> > and error handling is a lot faster in tree while we sort out all the
> > issues. Once it's good we can move things into something that's pip
> > installable.
>
> Sounds good, thanks for pushing on this. Looking forward to using it in
> ironic. :)


Hi Jim,
A tidbit just for ironic, please review
https://review.openstack.org/#/c/245459 and then we can use that content to
migrate over with the tooling we're creating now. With a good technical
review now your content will be in good shape.
Thanks,
Anne


>
> // jim
>
> >
> >       -Sean
> >
> > --
> > Sean Dague
> > http://dague.net
> >
> >
> __________________________________________________________________________
> > 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
>
> __________________________________________________________________________
> 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
>



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


More information about the OpenStack-dev mailing list