← Back to team overview

openstack team mailing list archive

[Docs] What's Up Doc? September 19 2012


Hi all -
Here's the weekly report from docs land. Thanks for reading!

tl;dr - Still over 100 doc bugs, 18 targeted for folsom, 11 of those
18 do not have assignees. New docs landing pages from
https://review.openstack.org/#/c/11232/ should land this week or next
prior to the release date.

1. In review and merged this past week:
Hyper-V documentation now included in the Hypervisors chapter of the
Compute Admin guide. Nice teamwork and tenacity Peter and gang.
Document VMs with disks stored in LVM.
Fixes to Compute API docs for security group update and keypair
example correction.
Links to CLI guide for nova.
Link to Quantum API 2.0 guide from API docs landing page.
Glossary now available at

Please review:
Instance Management chapter shaping up nicely:
In about a week or less, the landing pages will change with this
patch: https://review.openstack.org/#/c/11232/. Please review to weigh
in on the new design.
Brought in tested Compute API samples for api.openstack.org here:
Cloudpipe documentation for Folsom: https://review.openstack.org/#/c/13281/
Essex nova.conf example files: https://review.openstack.org/#/c/13157/
Addition of os-server-diagnostics extension doc:
Cover XenServer configurations for Migration:

2. High priority doc work:
Networking admin information being brought in, please review
Volumes admin information, please update existing for folsom
Configuration information: need to determine if all nova.conf options
are in the folsom
Hypervisor and scheduler information: Hypervisors can now co-exist --
update docs https://bugs.launchpad.net/openstack-manuals/+bug/1048879

3. Doc work going on that I know of:
Diane Fleming is bringing the Quantum Admin manual into the
openstack-manuals repository this week.
David Hendler has asked John Griffith to review the Volume API 1.0
spec for bringing into the new volume-api repository.
Dolph M is working on a markdown version of the Identity API 3.0
document to bring it into the Gerrit workflow process.

4. New incoming doc requests:
"Just" everything targeted for Folsom. Insert maniacal laugh here.

5. Doc tools updates:
Testing in progress for the doc tools bugs that the tools team is working on
this sprint, see http://bit.ly/Q9eGsu for the list.

6. Other doc news:
Still seeking proposals for the Documentation Track at the Design
Summit - go to http://summit.openstack.org to propose your awesome doc
topic for discussion. While it looks like there are two proposed, one
of the proposers can't attend, so I'm definitely seeking more.