Hi all - <br><br>We have three projects that need to have draft API docs (for a new API version) published for feedback and consumption during the Essex timeframe. (Quantum 1.0>1.1, Glance 1.1>2.0, and Nova 1.1>2.1)<br>

<br>I'd like to get ideas about where those should be published and some of the requirements around their draft status. <br><br><ol><li>Is there a need for special treatment for "RFC" vs. "Draft" designations such as RFC for a certain time period, then Draft?</li>

<li>Do these need drafts need to be published to <a href="http://docs.openstack.org/api">docs.openstack.org/api</a>, or is that site for "final" APIs for end-users? I envision introducing more confusion than is already present if we publish them side-by-side.</li>

<li>Do these API drafts need their own site for the RFC/Draft period, such as <a href="http://api.openstack.org/drafts">api.openstack.org/drafts</a>?</li><li>What do other projects do with their draft APIs that you like? </li>

</ol>Thanks for your input. At the team meeting I got *crickets* when I asked. :) I'd like to set up a site that's as lights-out and automated as possible, no need for me to be a gatekeeper on this info, but some up-front info architecture will help people find and use the info.<br>

<br>Thanks,<br>Anne<br><div style="margin: 2em 0pt;" name="sig_d41d8cd98f"><div style="padding: 5px; font-size: 11px; color: rgb(102, 102, 102); font-family: sans-serif;">
<strong>Anne Gentle</strong>
 <br>
<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a><br>
<div style="font-size: 10px;">
<a href="http://justwriteclick.com/" target="_blank">my blog</a> |
<a href="http://xmlpress.net/publications/conversation-community/" target="_blank">my book</a> |
<a href="http://www.linkedin.com/in/annegentle" target="_blank"><span>LinkedIn</span></a> | <a href="http://del.icio.us/annegentle" target="_blank">Delicious</a> |
 <a href="http://twitter.com/annegentle" target="_blank">Twitter</a>

</div></div></div>