<div dir="ltr">Hi all, <div>In working on this spec [1] to replace the WADL-built API references with Swagger-built API references, I found a possible interim solution that builds flat HTML files from Swagger. [2] So, instead of using swagger-ui running on a web server, we could write a script to build one HTML file per service, much like the current WADL scripts do.</div><div><br></div><div>Then, we continue working on fairy-slipper to best display both reference data and how-to/concept information together.</div><div><br></div><div>As an idea of what I would consider "code complete" for the migration:</div><div>1. All services WADL files migrate without any errors in the <a href="http://logs.openstack.org/57/281657/1/check/gate-build-swagger/993145e/" style="color:rgb(6,84,172);font-family:sans-serif">gate-build-swagger</a> job. Currently the Networking API files have the most errors and the team is looking into it. I've been logging bugs when the tool finds errors when migrating WADL.</div><div>2. All current HTML pages on <a href="http://developer.openstack.org/api-ref.html">developer.openstack.org/api-ref.html</a> can be redirected.</div><div><br></div><div>However, defining "good enough" for the fairy-slipper display and interaction piece is more complex. So I believe an interim solution that migrates the WADL and gets off of WADL and clouddocs-maven-plugin for builds is a good way forward.</div><div><br></div><div>What do you all think? Karen, Russell, and Mike McCune I'd definitely like your input.</div><div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div><br></div><div>1. <a href="https://review.openstack.org/#/c/276484/">https://review.openstack.org/#/c/276484/</a></div><div>2. <a href="https://github.com/nknapp/bootprint-openapi">https://github.com/nknapp/bootprint-openapi</a><br clear="all"><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>