<div dir="ltr">







<p class="">Hi all, </p><p class="">I'm excited to be going to the Grace Hopper Conference tomorrow, where I'll be with over 4500 other women in computing. I've never seen anything like it and I can't wait. Iccha Sethi and I are running an OpenStack workshop for Open Source day Saturday in Minneapolis. Wish us luck! I've spun up 20 Rackspace Cloud Servers and I've got some DevStack .ova files as backup. See all the plans in store at <a href="https://etherpad.openstack.org/ghc-os">https://etherpad.openstack.org/ghc-os</a>.</p>

<p class="">On to docland!</p><p class="">1. In review and merged this past week:</p>
<p class="">Over 85 patches merged in the last week and a half so I won't go through them all. Some highlights include:</p><p class="">- Update auto-documented configuration items (1500 options in all of OpenStack, documented).</p>

<p class="">- Removing the API Programming Guide for inaccuracies, working on a blueprint for an all-in-one API Guide. [1]</p><p class="">- Document cinder quotas<br></p><p class="">- Merged Neutron docs with other all-OpenStack docs</p>


<p class="">2. High priority doc work:</p>
<p class="">The install guide is the highest priority right now. Shaun is working on drafts in his Github repo at [2] and will patch to openstack-manuals this week, today (hump day!) or tomorrow.</p>
<p class="">3. Doc work going on that I know of:</p>
<p class="">Diane and I tested HTML and PDF output for all the books, using the 1.10.0 plugin, and made some patches when we found fixes were needed in the XML source. </p><p class="">Otherwise we should all focus on doc bugs: </p>

<p class=""><a href="https://bugs.launchpad.net/openstack-manuals/+milestone/havana">https://bugs.launchpad.net/openstack-manuals/+milestone/havana</a> -- 92 confirmed, 129 released<br></p><p class="">and</p><p class="">
<a href="https://bugs.launchpad.net/openstack-api-site/+milestone/havana">https://bugs.launchpad.net/openstack-api-site/+milestone/havana</a> -- 48 confirmed, 20 fix released<br>
</p>
<p class="">4. New incoming doc requests:</p>
<p class="">Release the havana docs October 17th!</p>
<p class="">5. Doc tools updates:</p>
<p class="">The bug reporting link is available in 1.11.0 and we will finalize on that in all the pom.xml files for the havana release. See the release notes for the highlights. [3]<br></p><p class="">We had a request this week to build HTML and PDF to docs-draft, I'd love to see someone pick up the work started at  <a href="https://review.openstack.org/#/c/22768/">https://review.openstack.org/#/c/22768/</a> and make it happen.</p>


<p class="">6. Other doc news:</p><p class="">David Cramer and I are scheduling a meeting with OxygenXML to discuss the donated licenses they give us. The last batch of six month licenses expires this month so this is a high priority. We found at the boot camp that while many people don't need Oxygen, it's nice to have the editor for certain types of authoring such as WADL creation and maintenance.</p>

<p class="">We had a discussion about licensing for the documentation on the openstack-docs mailing list that might interest someone. I'd like a volunteer to work with a legal rep to find out advice for moving forward on licensing, please let me know if you're interested.</p>

<p class="">If you're looking for a Gerrit search that lets you see all the reviews going in all the doc repos, paste this into the search box on <a href="http://review.openstack.org">review.openstack.org</a>:</p>status:open (project:openstack/openstack-manuals OR project:openstack/api-site OR project:openstack/object-api OR project:openstack/image-api OR project:openstack/identity-api OR project:openstack/compute-api OR project:openstack/volume-api OR project:openstack/netconn-api OR project:openstack/operations-guide)<p class="">

Hat tip to Sean Dague for writing this up in his blog. [4]</p><p class="">1. <a href="https://blueprints.launchpad.net/openstack-manuals/+spec/blueprint-os-api-docs">https://blueprints.launchpad.net/openstack-manuals/+spec/blueprint-os-api-docs</a></p>

<p class="">2. <a href="https://github.com/shaunix/openstack-manuals/tree/master/doc/install-guide">https://github.com/shaunix/openstack-manuals/tree/master/doc/install-guide</a></p><p class="">3. <a href="https://github.com/rackerlabs/clouddocs-maven-plugin/blob/master/README.rst">https://github.com/rackerlabs/clouddocs-maven-plugin/blob/master/README.rst</a></p>

<p class="">4. <a href="http://dague.net/2013/09/27/gerrit-queries-to-avoid-openstack-review-overload/">http://dague.net/2013/09/27/gerrit-queries-to-avoid-openstack-review-overload/</a></p></div>