<div dir="ltr">What's new with you? Here's what's new in OpenStack doc-land.<br><div><br><div>1. In review and merged this past week:<br></div><div>Diane Fleming was on fire this week, renaming all the guides in the <product>-api repos to "API v <n> Reference". See <a href="http://docs.openstack.org/api/api-ref-guides.html">http://docs.openstack.org/api/api-ref-guides.html</a> for the list of links with the new names. <br>

<br></div><div>She also fixed the Identity API v 2.0 guide to include all the client and admin calls and extensions. This closes a bug logged about a year ago. <a href="https://review.openstack.org/#/c/30216/">https://review.openstack.org/#/c/30216/</a> Just a little more clean up to go. This was a huge effort (I tried to do it myself and failed.) :) <br>

</div><div><br>2. High priority doc work:<br>Diane's working on a user guide, as part of the refactoring. Please review the outline at <a href="https://wiki.openstack.org/wiki/Blueprint-os-user-docs#Summary">https://wiki.openstack.org/wiki/Blueprint-os-user-docs#Summary</a>. I've given her (way too many) ideas for use cases, but more are welcomed as we shape this new deliverable.<br>

<br>3. Doc work going on that I know of:<br></div><div>Diane's also got a review in progress, <a href="https://review.openstack.org/#/c/30332/">https://review.openstack.org/#/c/30332/</a>, that changes the doc landing page to flatten the hierarchy. Please review. <br>

<br></div><div>4. New incoming doc requests:<br></div><div>Tempest wants to build docs for the <a href="http://qa.openstack.org">qa.openstack.org</a> site and is working on a patch at <a href="https://review.openstack.org/#/c/30434/">https://review.openstack.org/#/c/30434/</a>. <br>

<br></div><div>I talked with John Dickinson, Swift PTL, about a real "specification" for version 1.0 of the Object Storage API. I explained our framework and governance over the <project>-api repositories so that he can get started.<br>

</div><div><br>5. Doc tools updates:<br></div><div>At the Infrastructure team meeting this week the team noted they are working on having Jenkins do releases to Maven, so that OpenStack Jenkins can build the cloud doc tools maven plugin and release it for our use -- this enables any OpenStack contributor to work on the Maven plugin.<br>

<br></div><div>I'm trying to figure out if Oxygen 14 has stopped doing the line wrap at 70 that we indicate as the standard in our <a href="http://wiki.openstack.org/Documentation/Conventions">http://wiki.openstack.org/Documentation/Conventions</a> page. On my system it doesn't seem to be doing what it did with version 13.<br>

</div><div><br>6. Other doc news:<br><div>The Infrastructure team and I are meeting with technical contacts 
at O'Reilly to ask questions about their system and whether our 
contributors can continue to work on the Operations Guide in synch with 
any editor work they have going on. The contract is still under 
discussion so it's not a done deal yet but we want to be sure there are 
no technical hurdles.<br><br></div><div>The hardening guide sprint is happening next month at a yet-undisclosed location, headed up by Bryan Payne and Keith Basil. They have enough writers already but I'm sure they would appreciate good reviews.<br>

<br><br></div><br>
</div></div></div>