<div dir="ltr">Hi all,<div>The doc team has been hard at work producing new titles and improving upon the existing. We all have a lot of work to do before the Oct. 17th release but I wanted to report on the doc plans and get your input. </div>
<div><br></div><div>Where we are: there are now 9 core/integrated programs needing documentation [1]. <span style="font-size:13px;font-family:arial,sans-serif">I'm really excited about the new </span>docs<span style="font-size:13px;font-family:arial,sans-serif"> we have for this release -- the new Virtual Machine Image Guide [2], the new End User Guide[3], and the new Configuration Reference Guide [4]. </span></div>
<div><br></div><div>Our mission: when people come to <a href="http://docs.openstack.org">docs.openstack.org</a>, they want integrated docs across projects. We aim to provide completed installation and configuration docs by the release date. However, the administration guides may need to go to a "rolling release" where they may not be complete or accurate for a given release like havana. This is not ideal but is one tactic for handling the influx of doc needs with the timing of the resource availability.</div>
<div><br></div><div>Released Oct 17th:</div><div>OpenStack Installation Guide - Shaun McCance is contracting for Cisco to write a new "choose your own adventure" installation guide. We want to get rid of the four Install Guides we have now and consolidate to one for yum, one for apt.</div>
<div>OpenStack Configuration Reference - Much of this is auto generated through Oslo. Look for patches like this one and help a doc writer out when you can. <a href="https://review.openstack.org/#/c/40271/">https://review.openstack.org/#/c/40271/</a></div>
<div><br></div><div>Continuous release:</div><div>For OpenStack Administration and Operation:</div><div><span style="font-family:arial,sans-serif;font-size:13px"> - Block Storage Service Administration Guide</span><br></div>
<div><span style="font-family:arial,sans-serif;font-size:13px"> - Compute Administration Guide (contains Identity and Images)</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Networking Administration Guide</span><br>
<span style="font-family:arial,sans-serif;font-size:13px"> - Object Storage Administration Guide</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Admin User Guide</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Operations Guide</span><br>
<span style="font-family:arial,sans-serif;font-size:13px"> - High Availability Guide</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Security Guide</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Virtual Machine Image Guide</span><br>
<br>For OpenStack APIs and CLIs:</div><div><span style="font-family:arial,sans-serif;font-size:13px"> - End User Guide</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - API Quick Start</span><br style="font-family:arial,sans-serif;font-size:13px">
<span style="font-family:arial,sans-serif;font-size:13px"> - API Complete Reference</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Block Storage Service API v2 Reference</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Compute API v2 and Extensions Reference</span><br>
<span style="font-family:arial,sans-serif;font-size:13px"> - Identity Service API v2.0 Reference</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Networking API v2.0 Reference</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Image Service API v2 Reference</span><br>
<span style="font-family:arial,sans-serif;font-size:13px"> - Image Service API v1 Reference</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Object Storage API v1 Reference</span><br><span style="font-family:arial,sans-serif;font-size:13px"> - Programming Compute API with Shell and Python, 1st ed.</span><br>
</div><div><br></div><div>We track doc bugs against them and with the incoming DocImpact targeting we know we have over 70 doc bugs ready to be worked on. [5] I know that in your weekly meetings many of you are going to focus on docs after the feature freeze and we want to help you find the right placement for the docs. I know it's a daunting list of titles but we're here to help. </div>
<div><br></div><div>Let me know your input on "continuous release with bug tracking" for the guides in the list above. If you have additional ideas, I'd love to hear them. I'm definitely pondering the integrated programs doc strategies and open to ideas. We've been discussing on openstack-docs but want to bring the discussion to a larger group so please reply to openstack-dev.</div>
<div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div>1. <a href="https://wiki.openstack.org/wiki/Programs">https://wiki.openstack.org/wiki/Programs</a></div><div>2. <a href="http://docs.openstack.org/trunk/openstack-image/content/">http://docs.openstack.org/trunk/openstack-image/content/</a></div>
<div>3. <a href="http://docs.openstack.org/user-guide/content/">http://docs.openstack.org/user-guide/content/</a></div><div>4. <a href="http://docs.openstack.org/trunk/openstack-config/content/index.html">http://docs.openstack.org/trunk/openstack-config/content/index.html</a></div>
<div>5. <a href="https://bugs.launchpad.net/openstack-manuals/+milestone/havana">https://bugs.launchpad.net/openstack-manuals/+milestone/havana</a></div></div>