Hi all,
Sorry I missed the IRC meeting this week, I could've explained there, but
did see the request to ask on the list so here we go!

In order to serve API reference docs, we need a Pecan server on a cloud
server of some sort. I'm guessing this server could be deployed with Puppet
but I really don't know.

The specification for revising API docs [1] gives some detail about the
fairy-slipper tool [2] being developed that gets us out of WADL and into
JSON. The JSON needs a Python web framework to host the reference content.
An example of the output is at [3].

This isn't about the swift/static files solution but about a web framework.
What do you think?
Thanks,
Anne


1.
http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html
2. https://github.com/russell/fairy-slipper
3. http://fairy-slipper.russellsim.org/swagger-ui-jensoleg/#!/versions/get

-- 
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com
_______________________________________________
OpenStack-Infra mailing list
[email protected]
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-infra

Reply via email to