<div dir="ltr">Here's the news from doc land. <div><br></div><div>Install Guides are no longer publishing to <a href="http://docs.openstack.org/trunk" target="_blank">docs.openstack.org/trunk</a>. They are published only to a release such as <a href="http://docs.openstack.org/juno" target="_blank">docs.openstack.org/juno</a> or <a href="http://docs.openstack.org/icehouse" target="_blank">docs.openstack.org/icehouse</a>. Also this patch removes the Debian Install Guide until the instructions are fixed so that users can have a working install upon completion. [1]<div><br></div><div>API docs now officially in the attic and all <a href="http://docs.openstack.org/api/" target="_blank">docs.openstack.org/api/</a> links now redirect to the API reference at <a href="http://developer.openstack.org/api-ref.html" target="_blank">http://developer.openstack.org/api-ref.html</a>. </div><div><br></div><div>We really want to ensure that driver documents get streamlined this release. The specification is at <a href="https://review.openstack.org/#/c/133372/" target="_blank">https://review.openstack.org/#/c/133372/</a>. Paging Arkady Kanevsky, please examine that review so we can find a path forward to improve driver docs across multiple projects.</div><div><br></div><div>We've merged 89 patches in the last week across all the docs repos.</div><div><br></div><div>Much gratitude to the bug triaging efforts this past week, looks like at least 50 doc bugs were triaged this week. Thank you!</div><div><br></div><div>With over 500 doc bugs, we are still very much behind in fixing doc bugs, especially those that come in from DocImpact automation. If you've had a patch land with DocImpact, please follow up on the doc bug in <a href="http://bugs.launchpad.net/openstack-manuals" target="_blank">http://bugs.launchpad.net/openstack-manuals</a> to at least triage it and hopefully fix it. Find us in #openstack-doc if you can't figure out which docs should be impacted.</div><div><br></div><div>We really need a way to indicate which OpenStack version introduces each of these two things:</div><div>- Ceilometer meters: The team is doing a great job of documenting their reference information; however, some meters aren't available until the Kilo release. Yet we don't have a way to indicate which meters are available in which release (like we do with say, the Configuration Reference.) Also, the meters don't have descriptions associated with them in the code itself, so doc updates are manual currently. Ideally we'd throw some automation at the problem. </div><div>- API Extensions: For the Compute and Identity APIs we have always recognized that our doc tool doesn't output any indicator of which release the extension is available in. [2]</div><div><br></div><div>Any and all ideas are welcomed!</div><div><br></div><div>Thanks,</div><div>Anne</div><div><br clear="all"><div>1. <a href="https://review.openstack.org/#/c/157037/" target="_blank">https://review.openstack.org/#/c/157037/</a></div><div>2. <a href="https://bugs.launchpad.net/openstack-api-site/+bug/1423716">https://bugs.launchpad.net/openstack-api-site/+bug/1423716</a> </div><br>
</div></div></div>