<div dir="ltr">Hi all, <div>Just kicked off announcing another round for the Outreach Program for Women, exciting! I also wanted to give a round up from the world of docs so here goes. </div><div><br></div><div><div>1. In review and merged this past week:</div>

<div><br></div><div>We've had a good number of reviews going through as well as changes to doc tools to improve including JSON validation. Also you can now substitute docs-draft instead of logs in the URL from a review and see built documentation. WOO.</div>

<div><br></div><div>2. High priority doc work:</div><div><br></div><div>I'd say our first priority is bug triage and fixing, for core projects first. For the operator docs (openstack-manuals) we're at 360 open bugs with over 50 to be triaged. For the API docs we have about 150 open bugs.</div>

<div><br></div><div>I attended the Trove mid-cycle meetup last week. They've got their API docs as a priority, and have a writer assigned to work on install docs. This is great news! So reviewers, be ready to take a look at patches. </div>

<div><br></div><div>As always, the install guide is a high priority. We're having a good discussion about the install guide and default configuration on the openstack-docs mailing list, feel free to join us.</div><div>

<br></div><div>3. Doc work going on that I know of:</div><div><br></div><div>Matt Kassawara and install crew have been working on a 3-node install with neutron on icehouse, nice work! Thanks Phil Hopkins, </div><div><br>
</div>
<div>The final-final edits to the Operations Guide ship today to go to their production team. I have been porting to the feature/edits branch about once a week to keep our master branch where we do reviews, and the feature/edits branch where production will occur. I'll back port the index entries about once a week.<br>

</div><div><br></div><div>Shaun McCance continues to work on scraping code for configuration options information and ensuring we capture all of the options across projects.</div><div><br></div><div>4. New incoming doc requests:</div>

<div><br></div><div>On the openstack-dev list we've had a conversation [2] about adding a Heat template authors chapter to the End User Guide. Who's interested in this? I'm going to ask a few select people I have in mind but also wanted to let you all know we're looking for great integration there.<br>

</div><div><br></div><div>5. Doc tools updates:</div><div><br></div><div>In order to publish Markdown documents like the Image API v2 spec, Andreas worked hard to get the openstack-doc-tools utility released a few times. Release notes are here: <a href="https://github.com/openstack/openstack-doc-tools#release-notes">https://github.com/openstack/openstack-doc-tools#release-notes</a>. Next up for the doc tools are testing JSON and XML API sample requests and responses (which uncovered over 80 flaws). Great improvements here. </div>

<div><br></div><div>6. Other doc news:</div></div><div><br></div><div>I've sent a request to add three questions about API documentation to the User Survey. [1]<br></div><div><br></div><div>Diane split the Conventions page into three parts: Writing Style, DocBook Markup, and WADL Markup. <br>

</div><div><br></div><div>I'm in San Antonio this week for an internal developer conference, so I'll be less available on IRC than usual. Still planning to run the weekly docs meeting though, so join in the fun! This week is the 4th Wednesday, see you at 14:00:00 UTC in #openstack-meeting-alt.</div>

<div><br></div><div>[1] <a href="http://lists.openstack.org/pipermail/user-committee/2014-February/000242.html">http://lists.openstack.org/pipermail/user-committee/2014-February/000242.html</a><br></div><div>[2] <a href="http://lists.openstack.org/pipermail/openstack-dev/2014-February/027129.html">http://lists.openstack.org/pipermail/openstack-dev/2014-February/027129.html</a></div>

</div>