<div dir="ltr">Hi all, <div><br></div><div>For Liberty I am working on a specification to update the way we deliver application developer information. [1] I'm incorporating Tom's suggestion to automate API reference information. [2]</div><div><br></div><div>In revising the API reference specification I wanted to ask a few more questions to shape the spec further.</div><div><br></div><div><div>* Should we do a proof of concept for say, Compute, then have the other projects</div><div>follow? Identity v3 has the most calls in the core with 74, but Compute v2 plus</div><div>extensions has over 120 calls. Alternatively, we could also limit the scope to "greater than 50% reported on User Survey [2]". </div><div><br></div><div>* Is there any way to know what versions of an API a user answering the survey is running or do we have to scope to both versions for some of these services?</div><div>Identity</div><div>Compute</div><div>Block Storage</div><div>Image<br></div><div><div>Networking</div></div><div><br></div><div><div>* Do we continue to enable the project teams to indicate where they want to maintain REST API information? Or does this spec require particulars down to the folder name in the repo due to automation efforts?</div></div><div><br></div><div>Feel free to reply here or in the spec itself.</div><div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div>1. <a href="https://review.openstack.org/#/c/177934/1">https://review.openstack.org/#/c/177934/1</a></div><div>2. <a href="http://lists.openstack.org/pipermail/openstack-docs/2015-April/006502.html">http://lists.openstack.org/pipermail/openstack-docs/2015-April/006502.html</a></div><div>3. <a href="http://superuser.openstack.org/articles/openstack-user-survey-insights-november-2014">http://superuser.openstack.org/articles/openstack-user-survey-insights-november-2014</a></div><div><br></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>