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

Jim Rollenhagen jim at jimrollenhagen.com
Fri Apr 1 18:02:08 UTC 2016


On Fri, Apr 01, 2016 at 10:13:49AM -0500, Anne Gentle wrote:
> 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

Fantastic! Nobody told me this was in progress. Thanks Anne!

// jim

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

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




More information about the OpenStack-dev mailing list