<div dir="ltr">Here is a link to the 7migration errors currently tracked with bugs:<div><br></div><div><a href="https://bugs.launchpad.net/openstack-api-site/+bugs?field.tag=migration">https://bugs.launchpad.net/openstack-api-site/+bugs?field.tag=migration</a><br></div><div><br></div><div>Two of these bugs are in progress. </div><div><br></div><div>Thanks,</div><div>Anne</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Feb 23, 2016 at 10:49 AM, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><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" target="_blank">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" target="_blank">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/" target="_blank">https://review.openstack.org/#/c/276484/</a></div><div>2. <a href="https://github.com/nknapp/bootprint-openapi" target="_blank">https://github.com/nknapp/bootprint-openapi</a><span class="HOEnZb"><font color="#888888"><br clear="all"><div><br></div>-- <br><div><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>
</font></span></div></div>
</blockquote></div><br><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>