<div dir="ltr"><div><div>Hi all -<br></div>Keeping to the topical nature of our lists, I'm going to post these to the openstack-docs list from now on. Forward to your friends and neighbors! <br><br></div>I don't know if I say this often enough, but it is truly an honor to work with such high-caliber technical people on OpenStack. Thank you all for your efforts.<br>
<div><div><div><br>1. In review and merged this past week:<br></div><div>Lots of new additions in the last few weeks:<br></div><div>From Emilien, more info in the High Availability guide, including Keystone HA, and updates to the Basic Install -- this guide gets a workout daily, I think. Lots of bug fixes. <br>
</div><div>From Tom and Lorin, tons of doc bug fixes, addressing doc comments, and just plain good fixes.<br></div><div>Lorin has documented trusted compute pools and added a new chapter called "Security Hardening" into the Compute Admin guide.<br>
</div><div>Lorin also is working on schema validation so our builds won't break due to invalid DocBook getting into the repo.<br></div><div>Alan Pevec has addressed a few annoyances with glance add commands lingering behind.<br>
</div><div>Eduardo Patrocinio has stuck it out with some fixes as well, thank you Eduardo.<br></div><div><br>2. High priority doc work:<br></div><div>Tom has done a great job of tagging and triaging DocImpact items. I'd like to start focusing on doc bugs where the Title starts with grizzly now that we are nearing g-3 deadlines. As you may know, docs never really keep up with code, but I'd like to make it a high priority.<br>
<br></div><div>Here are some general "features" going into Grizzly's Compute that people will want docs for:<br></div><div>-Cells (Lorin has a WIP draft started)<br></div><div>-Database independence for Compute (get rid if nova-manage commands)<br>
</div><div>-Extension for retrieving secure password for guest servers<br></div><div>-Better block storage interface coverage<br></div><div>-Improvements to boot-from-volume (some of these are documented? She says hopefully.)<br>
</div><div>-Bare metal provisioning (Do any docs exist?)<font><span style="font-family:arial,helvetica,sans-serif"><br>-Any new filters (I don't think
<span style="line-height:115%">AggregateMultiTenancyIsolation scheduler filter is documented?)</span></span></font><style>
<!--
/* Font Definitions */
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;
mso-font-charset:0;
mso-generic-font-family:auto;
mso-font-pitch:variable;
mso-font-signature:3 0 0 0 1 0;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-parent:"";
margin-top:0in;
margin-right:0in;
margin-bottom:10.0pt;
margin-left:0in;
line-height:115%;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:Calibri;
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-fareast-font-family:Calibri;
mso-fareast-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-bidi-font-family:"Times New Roman";
mso-bidi-theme-font:minor-bidi;}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;
mso-header-margin:.5in;
mso-footer-margin:.5in;
mso-paper-source:0;}
div.Section1
{page:Section1;}
-->
</style>
</div><div><br>3. Doc work going on that I know of:<br>Our intern Laura Alves has been doing a great job with API doc bugs.
And by great, I mean, fantastic. She's tracking with a spreadsheet [1] if you'd like to see how much
progress she's making on the Compute API and all its extensions. <br><br></div><div>I've also seen results from the OpenStack documentation jam at LCA, the Australian Linux Conf. [2] Tom has logged these four bugs to track their impressions. Since you only get to look at something for the first time once, these are valuable items I'd like to tackle:<br>
1110135 "getting started" link on <a href="http://openstack.org">openstack.org</a> is confusing for new users<br>1110136 installing openstack walkthrough doesn't let you know where to go<br>1110137 "running openstack" guide is exhausting to the point of being past useful<br>
1110146 <a href="http://docs.openstack.org">docs.openstack.org</a> "API" should be "using openstack" <br></div><div><br>4. New incoming doc requests:<br>The DNS project (moniker) team would like to get their API spec into the docs system, and are investigating the typical build process. <br>
<br>5. Doc tools updates:<br></div><div>I'm testing 1.7.1-SNAPSHOT as it has some fixes for the PDF file naming that we need, but it doesn't yet have the directory naming that we need, so work continues. I did a mockup of a navigation menu for the long API reference listing and attached it to the bug requesting navigation for that page. [3] <br>
</div><div><br>6. Other doc news:<br></div><div>Still gathering snippets for the Operator's manual sprint at the end of February. We'll be trying out a different authoring tool, "booki" through <a href="http://sourcefabric.org">sourcefabric.org</a> for the sprint itself. We'll bring it all into our normal toolset after the sprint.<br>
</div><div><br>1. <a href="https://docs.google.com/spreadsheet/ccc?key=0AlbmThWRMTApdEQ2dUcyNGNjVVNtaWI3bWJsRkdMbVE#gid=0">https://docs.google.com/spreadsheet/ccc?key=0AlbmThWRMTApdEQ2dUcyNGNjVVNtaWI3bWJsRkdMbVE#gid=0</a><br>
<br>2. <a href="https://lca2013.linux.org.au/wiki/OpenStack_Documentation_Jam_Session">https://lca2013.linux.org.au/wiki/OpenStack_Documentation_Jam_Session</a><br><br>3. <a href="https://bugs.launchpad.net/openstack-api-site/+bug/980228">https://bugs.launchpad.net/openstack-api-site/+bug/980228</a><br>
</div></div></div></div>