<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">I think we need a straight copy of Nova 1.1 -> Nova 2.0 that simply renames everything from 1.1 -> 2.0 and changes the endpoint url v1.1 -> v2<div><br></div><div>Also a big note saying that 2.0 is exactly the same as 1.1 but was renamed to avoid confusion with 1.0 when we pulled out the minor version from the url.</div><div><br></div><div>Having 2.1 in draft seems great to me. I think it is fine to have a draft docs available before RFC. It gives us a place to start working on stuff.</div><div><br></div><div>Vish</div><div><br><div><div>On Nov 8, 2011, at 2:54 PM, Anne Gentle wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">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>
_______________________________________________<br>Mailing list: <a href="https://launchpad.net/~openstack">https://launchpad.net/~openstack</a><br>Post to : <a href="mailto:openstack@lists.launchpad.net">openstack@lists.launchpad.net</a><br>Unsubscribe : <a href="https://launchpad.net/~openstack">https://launchpad.net/~openstack</a><br>More help : <a href="https://help.launchpad.net/ListHelp">https://help.launchpad.net/ListHelp</a><br></blockquote></div><br></div></body></html>