<div dir="ltr"><div><p class="">I'm happy to report the latest in doc-land. As always, each Monday you can come to our open office hours at 9:00 Pacific. This week we're changing the doc team meeting frequency to every other week, Tuesdays at 1300 UTC in #openstack-meeting. I don't know about your house but at my house we're happy that school is starting next week! Bring on the books.</p>
<p class="">1. In review and merged this past week:</p><p class="">We fixed and released 25 bugs last week, 17 for openstack-manuals and 8 for api-site.</p><p class="">The OpenStack Block Storage Admin Guide now contains only admin info and install and config info have been moved into those guides. We fixed a bug where the /trunk/ version of this guide was outputting incorrectly.</p>
<p class="">Shawn Hartsock got his first doc patch through for the VMWare docs, thanks Shawn!</p></div><div>
<p class="">2. High priority doc work:</p>
<p class="">Our reorg is in full force. This week I met with four core teams to ensure the OpenStack docs team can move around the Admin Guides per project into broader OpenStack guides. </p><p class="">We still have over 200 bugs for Havana. With a shift to focus on docs and bug fixing we sure hope to see lots of patches in the coming weeks.</p>
<p class="">3. Doc work going on that I know of:</p>
<p class="">
</p><p class="">Getting a lab set up for Shaun, our Cisco contractor, to test install instructions for OpenStack. Example architectures are here if you're interested: <a href="http://etherpad.openstack.org/havanainstall">etherpad.openstack.org/havanainstall</a>. He has purchased laptops to serve as his "lab" with USB/Ethernet NICs. </p>
<p class="">We're piecing out the Object Storage Admin Guide to other books in openstack-manuals and plan to stop creating that book separately. </p><p class="">OpenSUSE install instructions are in the repository for the basic install guide. I have to give a shout out to Andreas Jaeger and Christian Berendt for all the patches and reviews lately - thanks a bunch! OpenSUSE in the house!</p>
<div></div>
<p class="">4. New incoming doc requests:</p>
<p class="">On the openstack-docs list, we are still designing two admin-level guides. They are:</p>OpenStack Administration Guide – Covers system administration tasks like maintaining, monitoring, and customizing an initially installed system. Similar to the Operations Guide possibly.<br>
User Guide for Administrators - Covers user tasks performed through the dashboard and CLIs for admin users.</div><div><br></div><div>Bring any and all ideas to openstack-docs to join in the discussion.<br>
<p class="">5. Doc tools updates:</p>
<p class="">The 1.9.2 release of the clouddoctools-maven-plugin supports CALS tables markup. We're looking into a 1.9.3 release to add support for using Windows for building docs locally and fixing a wrapping problem for the Orchestration API. So it's likely we should wait for a 1.9.3 release before changing all the pom.xml files for the havana release.</p>
<p class="">6. Other doc news:</p><p class="">We documented our review policies here: <a href="https://wiki.openstack.org/wiki/Documentation/HowTo#Who_can_Review_Documentation.3F">https://wiki.openstack.org/wiki/Documentation/HowTo#Who_can_Review_Documentation.3F</a> to ensure clarity for the new contributors and current docs-core members. </p>
</div>
<div>We have over 25 people coming to the Docs Boot Camp and our host Mirantis will video tape the sessions. The OpenStack Foundation is supporting us greatly as well as Rackspace. Thanks supporters -- we're all looking forward to it!</div>
<div><br></div></div>