Couple of reasons from my perspective:<br><br>We've got to get me out of the loop for reviews of the API spec - I'm happy to review and would like to be a reviewer of all the API docs for OpenStack, but we need better governance of API updates. <br>

<br>Also, my goal was to move doc source to github prior to October 3. Based on this discussion, it also makes a decision about how many "books" per repo we have. I'm now leaning towards one repo per "book" deliverable.<br>

<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><div class="gmail_quote">On Tue, Aug 23, 2011 at 3:01 AM, Thierry Carrez <span dir="ltr"><<a href="mailto:thierry@openstack.org" target="_blank">thierry@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">


<div>Vishvananda Ishaya wrote:<br>
> Ultimately I would like the spec to be generated from the code, but as a<br>
> first pass, we should at least be able to edit the future version of the<br>
> spec as we make changes.  I've proposed the current version of the spec<br>
> here:<br>
><br>
> <a href="https://code.launchpad.net/%7Evishvananda/nova/add-api-docs/+merge/72506" target="_blank">https://code.launchpad.net/~vishvananda/nova/add-api-docs/+merge/72506</a><br>
><br>
> Are there any issues with this approach?<br>
<br>
</div>Looks like there are diverging opinions. That sounds like work for... a<br>
design summit brainstorm session !<br>
<br>
Any reason why we'd need to discuss this *now*, as opposed to after<br>
Diablo is released ?<br>
<font color="#888888"><br>
--<br>
Thierry Carrez (ttx)<br>
Release Manager, OpenStack<br>
</font><div><div></div><div><br>
_______________________________________________<br>
Mailing list: <a href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
Post to     : <a href="mailto:openstack@lists.launchpad.net" target="_blank">openstack@lists.launchpad.net</a><br>
Unsubscribe : <a href="https://launchpad.net/%7Eopenstack" target="_blank">https://launchpad.net/~openstack</a><br>
More help   : <a href="https://help.launchpad.net/ListHelp" target="_blank">https://help.launchpad.net/ListHelp</a><br>
</div></div></blockquote></div><br>