<div dir="ltr">Hi all, <br>I wanted to give an update on the efforts to provide improved application developer information on <a href="http://developer.openstack.org">developer.openstack.org</a>. Wrangling this much valuable information and gathering it in a way that helps people is no simple matter. So. We move forward one step at a time.<br><br>What's new?<div>----------------<br>This week, with every build of the api-site, we are now running fairy-slipper to migrate from WADL to Swagger for API reference information. Those migrated Swagger files are then copied to <a href="http://developer.openstack.org/draft/swagger">developer.openstack.org/draft/swagger</a>. <br><br>We know that not all files migrate smoothly. We'd love to get teams looking at these migrated files. Thank you to those of you already submitting fixes! <br><br>In addition, the infra team is reviewing a spec now so that we can serve API reference information from the <a href="http://developer.openstack.org">developer.openstack.org</a> site: <a href="https://review.openstack.org/#/c/276484/">https://review.openstack.org/#/c/276484/</a><br><br>Why are we doing all this?<br>----------------------------------<br>The overall vision is still intact in the original specifications [1][2], however we need to do a lot of web design and front end work to get where we want to be.<br><br>What can I do?</div><div>--------------------<br>Check out these Swagger files.<br><a href="http://developer.openstack.org/draft/swagger/blockstorage-v1-swagger.json">http://developer.openstack.org/draft/swagger/blockstorage-v1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/blockstorage-v2-swagger.json">http://developer.openstack.org/draft/swagger/blockstorage-v2-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/clustering-v1-swagger.json">http://developer.openstack.org/draft/swagger/clustering-v1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/compute-v2.1-swagger.json">http://developer.openstack.org/draft/swagger/compute-v2.1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/data-processing-v1.1-swagger.json">http://developer.openstack.org/draft/swagger/data-processing-v1.1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/database-v1-swagger.json">http://developer.openstack.org/draft/swagger/database-v1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/identity-admin-v2-swagger.json">http://developer.openstack.org/draft/swagger/identity-admin-v2-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/identity-extensions-v2-swagger.json">http://developer.openstack.org/draft/swagger/identity-extensions-v2-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/identity-extensions-v3-swagger.json">http://developer.openstack.org/draft/swagger/identity-extensions-v3-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/identity-v2-swagger.json">http://developer.openstack.org/draft/swagger/identity-v2-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/identity-v3-swagger.json">http://developer.openstack.org/draft/swagger/identity-v3-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/image-v1-swagger.json">http://developer.openstack.org/draft/swagger/image-v1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/networking-extensions-v2-swagger.json">http://developer.openstack.org/draft/swagger/networking-extensions-v2-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/networking-v2-swagger.json">http://developer.openstack.org/draft/swagger/networking-v2-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/objectstorage-v1-swagger.json">http://developer.openstack.org/draft/swagger/objectstorage-v1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/orchestration-v1-swagger.json">http://developer.openstack.org/draft/swagger/orchestration-v1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/share-v1-swagger.json">http://developer.openstack.org/draft/swagger/share-v1-swagger.json</a><br><a href="http://developer.openstack.org/draft/swagger/telemetry-v2-swagger.json">http://developer.openstack.org/draft/swagger/telemetry-v2-swagger.json</a><br><br>If you see a problem in the original WADL, log it here: <a href="https://bugs.launchpad.net/openstack-api-site">https://bugs.launchpad.net/openstack-api-site</a>. If you see a problem with the migration tool, log it here: <a href="https://bugs.launchpad.net/openstack-doc-tools">https://bugs.launchpad.net/openstack-doc-tools</a>.</div><div><br></div><div>When will the work be completed?</div><div>--------------------------------------------</div><div><br></div><div>I had hoped to have more to show by this point, but I await the infra team's review of the server spec above, and we continue to work on the bugs in the migration and output. Once the server spec work is complete, we can release the draft site.</div><div><br>What if I have more questions?</div><div>------------------------------------------<br>You can always hop onto #openstack-doc or #openstack-sdks to ask me or another API working group member for guidance.</div><div><br></div><div>Last but not least, if you want to learn more about Swagger in the upstream contributors track at the Summit, vote for this session: <br><a href="https://www.openstack.org/summit/austin-2016/vote-for-speakers/presentation/7723">https://www.openstack.org/summit/austin-2016/vote-for-speakers/presentation/7723</a></div><div><br></div><div>Thanks,<br>Anne<br><br>--<br>Anne Gentle<br>Rackspace<br>Principal Engineer<br><a href="http://www.justwriteclick.com">www.justwriteclick.com</a><br><br>1. <a href="http://specs.openstack.org/openstack/docs-specs/specs/mitaka/app-guides-mitaka-vision.html">http://specs.openstack.org/openstack/docs-specs/specs/mitaka/app-guides-mitaka-vision.html</a><br>2. <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><div>
</div></div></div>