<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Aug 1, 2013 at 3:27 PM, Tom Fifield <span dir="ltr"><<a href="mailto:tom@openstack.org" target="_blank">tom@openstack.org</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">> The titles that we'll release Oct 17th, regardless of number of bugs, are:<br>
><br>
</div><div class="im">>  - Compute Administration Guide (contains Identity and Images)<br>
<br>
<br>
</div>I disagree with releasing inaccurate information, and would instead opt<br>
for incomplete documentation. Very important distinctions in types of<br>
bugs - those that denote something missing and those that denote<br>
something is wrong.<br></blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Then, I believe that just verifying the accuracy of the information in<br>
the Compute Administration Guide (i.e. we don't have bugs for many areas<br>
that are potentially wrong) is going to take a lot of effort, and I have<br>
yet to see where this will come from. </blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
My suggestion would be to focus on the documents that we can make<br>
accurate prior to release and publish the 'full library' at a later date.<br>
<div class="HOEnZb"><div class="h5"><br></div></div></blockquote><div><br></div><div>So nice to have you in our time zone Tom. :)</div><div><br></div><div>I think the actual design layout will help us realize that "releases" will look different for Havana. We won't have that redesign for a few weeks, so we're talking abstractedly but have concrete views already cemented. </div>

<div><br></div><div>I'm asserting that the only guides that we can ever guarantee to be synchronized with released code are install and config (automated). All others are released continuously. Yes it means inaccuracies may exist but bugs exist in the code too. We can certainly leave out entire sections or chapters if they're just too buggy. </div>

<div><br></div><div>I don't think that there will be a Havana Compute Administration Guide on October 17th, there will be a "continuously published from master" Compute Administration Guide. </div><div><br>
</div>
<div>The ownership is what concerns me -- Neutron "owns" their Networking Admin Guide, so does Cinder. Nova and Swift, not so much ownership. So are you proposing removal of Compute Admin Guide and Object Storage Admin Guide until owners step up? I can certainly consider that here.</div>

<div><br></div><div>I think we agree -- its just that the full Havana library is just two books. The rest of the books are on the shelf with a published date on them. I hope the redesign will help users understand this.</div>

<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">
<br>
Regards,<br>
<br>
<br>
Tom<br>
<br>
<br>
<br>
<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>