<div dir="ltr">
<p class="">Less than a month until the Oct. 17th timed release! We're in better shape than in past releases but the install guide consolidation is crucial and there are many doc bugs. It's crunch time!</p><p class="">
1. In review and merged this past week:</p>
<p class="">Congrats to Michael Still for his first doc patches to openstack-manuals! He got his new skillz at boot camp. Thanks for the patches!</p><p class="">I see good doc bug fixes going in, and Tom put in an update to the auto-generated tables. </p>
<p class="">We had a lot of cleanup to do for the flattening of directories but I think it has mostly settled now. The last step is to move the Networking Admin Guide's content into the correct locations (install or config or admin). Nermina's on it, assigned to bug <span style="font-size:13px;font-family:arial,sans-serif"> </span><a href="https://bugs.launchpad.net/openstack-manuals/+bug/1223542" target="_blank" style="font-size:13px;font-family:arial,sans-serif">https://bugs.launchpad.net/openstack-manuals/+bug/1223542</a><font face="arial, sans-serif">. </font></p>
<p class=""><font face="arial, sans-serif">Andreas has a good Etherpad going to talk about continuous publishing: </font><a href="https://etherpad.openstack.org/Continous_Publishing" target="_blank" style="font-size:13px;font-family:arial,sans-serif">https://<span class="" style="background-color:rgb(255,255,204);color:rgb(34,34,34)">etherpad</span>.openstack.org/Continous_Publishing</a>. It's possible we'll need to release the Cloud Admin Guide as well due to many references to configuration files. Please join in the discussion as we only have less than a month until release!</p>
<p class="">2. High priority doc work:</p>
<p class="">The install guide remains a high priority as do doc bugs. Shaun is working on a patch this week to consolidate the basic-install to create one single-sourced install-guide (which will document for yum, apt, and zypper). There were over 300 doc bugs in openstack-manuals earlier this week as some docimpact bugs got logged, but we are making decent progress.</p>
<p class="">We also need to have someone re-run the autodoc tables and try to match up with some of the storage patches in this week: <a href="https://review.openstack.org/#/c/47044/">https://review.openstack.org/#/c/47044/</a> and <a href="https://review.openstack.org/#/c/47118/">https://review.openstack.org/#/c/47118/</a>. </p>
<p class="">3. Doc work going on that I know of:</p><p class="">Kersten Richter is working on the Compute API docs again and getting an environment set up. <br></p>
<p class="">4. New incoming doc requests:</p>
<p class="">At the Doc Boot Camp, Joe Gordon asked me to write up a checklist of sorts for what info should go along with a DocImpact flag. I wrote up my ideas in a blog post and would love more input before putting it on the wiki. </p>
<p class=""><a href="http://justwriteclick.com/2013/09/17/openstack-docimpact-flag-walk-through/">http://justwriteclick.com/2013/09/17/openstack-docimpact-flag-walk-through/</a></p>
<p class="">5. Doc tools updates:</p>
<p class="">We had a 1.10.0 release today but had to revert back to 1.9.3 due to the request/responses not appearing in the API reference page. David Cramer's aware of the problem and will work through it. </p><p class="">
We also had a breakthrough where we can now link to WADL files in separate repositories so we have a single source of truth. Thanks to Mike Asthalter for testing! He reported that you can use this syntax in the xml doc where you want to refer to the WADL:<br>
<br><wadl:resources<br> href="<a href="http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl">http://git.openstack.org/cgit/openstack/api-site/plain/api-ref/src/wadls/orchestration-api/src/v1/orchestration-api.wadl</a>"<br>
xmlns:wadl="<a href="http://wadl.dev.java.net/2009/02">http://wadl.dev.java.net/2009/02</a>"/></p>
<p class="">6. Other doc news:</p><p class="">We had a great time at Docs Boot Camp. I wrote up a blog entry and posted some pictures:</p><p class=""><a href="http://justwriteclick.com/2013/09/13/openstack-docs-boot-camp-wrap-up/">http://justwriteclick.com/2013/09/13/openstack-docs-boot-camp-wrap-up/</a><br>
</p><p class=""><a href="https://plus.google.com/photos/107069996006011564519/albums/5922817305073319953?authkey=CN6V5c_Aq_9w">https://plus.google.com/photos/107069996006011564519/albums/5922817305073319953?authkey=CN6V5c_Aq_9w</a><br>
</p><p class="">Super happy to see both VMWare and RedHat hiring upstream OpenStack writers! <br></p><p class=""><a href="http://www.linkedin.com/redir/redirect?url=http%3A%2F%2Fjobs%2Eredhat%2Ecom%2Fjobs%2Fdescriptions%2Ftechnical-writer-brisbane-queensland-australia-job-1-3925604&urlhash=XXzf" target="_blank" style="margin:0px;padding:0px;border:0px;outline:0px;font-size:13px;font-family:Helvetica,Arial,sans-serif;vertical-align:baseline;text-decoration:none;color:rgb(0,102,153);line-height:15px">http://jobs.redhat.com/jobs/descriptions/technical-writer-brisbane-queensland-australia-job-1-3925604</a><span class="" style="margin:0px;padding:0px;border:0px;outline:0px;font-size:13px;font-family:Helvetica,Arial,sans-serif;vertical-align:baseline;color:rgb(0,0,0);line-height:15px"><br>
<br></span><a href="http://www.linkedin.com/redir/redirect?url=http%3A%2F%2Fjobs%2Evmware%2Ecom%2Fjob%2FPalo-Alto-Sr_-Technical-Writer%252C-OpenStack-Job-CA-94301%2F7043400%2F&urlhash=ZeSC" target="_blank" style="margin:0px;padding:0px;border:0px;outline:0px;font-size:13px;font-family:Helvetica,Arial,sans-serif;vertical-align:baseline;text-decoration:none;color:rgb(0,102,153);line-height:15px">http://jobs.vmware.com/job/Palo-Alto-Sr_-Technical-Writer%2C-OpenStack-Job-CA-94301/7043400/</a><br>
</p></div>