<div dir="ltr"><div>__In review and merged this past week__</div><div><br></div><div>We're cleaning up the Architecture Design Guide continually and I got my proof copy yesterday. The green cover is lovely as part of the set. The interior PDF is made the master branch from today and you can get those print copies rolling! </div>
<div><br></div><div>The landing page is now available at <a href="http://docs.openstack.org/arch/">http://docs.openstack.org/arch/</a> and you can order a printed copy for yourself. If anyone wants to place an order for more than 50 copies of any of our books, contact me and I can get them to you for half price. Go get a dead tree copy today at <a href="http://www.lulu.com/content/15006967">http://www.lulu.com/content/15006967</a>!</div>
<div><br></div><div>The common glossary work continues as well, see <a href="http://specs.openstack.org/openstack/docs-specs/specs/juno/common-glossary-setup.html">http://specs.openstack.org/openstack/docs-specs/specs/juno/common-glossary-setup.html</a> for the spec.</div>
<div><br></div><div>We have review in progress for a templated set of landing pages so the HTML can be generated more consistently and we don't have to write HTML landing pages by hand. Thank you Christian! Review at <a href="https://review.openstack.org/#/c/112239/">https://review.openstack.org/#/c/112239/</a></div>
<div><br></div><div>__High priority doc work__</div><div><br></div><div>Thanks to all who participated in the networking guide swarm last week! Still has a few patches ready for review, and there's also a new spec for that guide. Let's ensure we're all on the same page (ha!) by reviewing the patch in docs-specs: <a href="https://review.openstack.org/#/c/113597/">https://review.openstack.org/#/c/113597/</a>. The next plans for the networking guide are to get the spec finished and then to fill in the outline with tested sections. Shaun is handling the spec and Nick Chase is coordinating. </div>
<div><br></div><div>__Ongoing doc work__</div><div><br></div><div>I've completed the WADL updates that enable removal of WADL from the book-like deliverables, the API References. Now I need to get the API References themselves merged. </div>
<div><br></div><div>Next, I'm working on a migration from docbook to RST for the API long-form documents, which are found here: <a href="http://docs.openstack.org/api/api-specs.html">http://docs.openstack.org/api/api-specs.html</a>. This work is part of a blueprint to move API specs to project repositories. [1]</div>
<div><br></div><div>What I'm hearing from Dolph Matthews is that those belong in the <project>-specs repos, so I'll start there with proposals. I like this approach for a couple of reasons: 1) it still has publishing available but 2) sets expectations that those are design specs. PTLs, I'll be in touch to let you know whether you have a document that is affected. So far it's:</div>
<div>Block Storage v2</div><div>Compute API v2</div><div>Identity API v2.0</div><div>Networking API v2.0</div><div>Object Storage API v1</div><div><br></div><div>The API Reference page is the user-oriented deliverable for APIs: <a href="http://developer.openstack.org/api-ref.html">http://developer.openstack.org/api-ref.html</a> which is still sourced from WADL in the openstack/api-site repository. I'm investigating replacements and welcome collaborators.</div>
<div><br></div><div>__New incoming doc requests__</div><div>
<br></div><div>None, our focus is on the Networking Guide, API doc work, the Architecture Guide readiness, and always the backlog of doc bugs and DocImpact.</div><div><br></div><div>__Doc tools updates__</div><div><br></div>
<div>We'll use a static site generator for the content in the openstack-manuals/www directory that builds our landing pages. It's Jinja2 (<a href="http://jinja.pocoo.org/">http://jinja.pocoo.org/</a>, already listed in the global requirements).</div>
<div><br></div><div>__Other doc news__</div><div><br></div><div>We're holding a Doc Bug Day Tuesday September 9th. Please join in during your timezone or work all 24 hours! <a href="https://wiki.openstack.org/wiki/Documentation/BugDay">https://wiki.openstack.org/wiki/Documentation/BugDay</a> </div>
<div><br></div><div>1. <a href="https://wiki.openstack.org/w/index.php?title=Blueprint-os-api-docs#Goal_4_-_Move_API_Specs_to_project_repositories_and_off_docs_landing_page">https://wiki.openstack.org/w/index.php?title=Blueprint-os-api-docs#Goal_4_-_Move_API_Specs_to_project_repositories_and_off_docs_landing_page</a></div>
<div><br></div></div>