<div dir="ltr">Hi all, <br>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!<div><br></div><div>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.</div><div><br></div><div>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].</div><div><br></div><div>This isn't about the swift/static files solution but about a web framework. What do you think?</div><div>Thanks,</div><div>Anne</div><div><br></div><div><br></div><div>1. <a href="http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html">http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html</a><br clear="all"><div>2. <a href="https://github.com/russell/fairy-slipper">https://github.com/russell/fairy-slipper</a></div><div>3. <a href="http://fairy-slipper.russellsim.org/swagger-ui-jensoleg/#!/versions/get">http://fairy-slipper.russellsim.org/swagger-ui-jensoleg/#!/versions/get</a> </div><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Anne Gentle</div><div>Rackspace</div><div>Principal Engineer</div><div><a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div></div></div>
</div></div>