settingsLogin | Registersettings

[openstack-dev] What's Up, Doc? 31 July 2015

0 votes

Hash: SHA1

Hi everyone,

This week, like last, was all about the RST conversion. With just a 48
hour long sprint, the Install Guide is almost complete! A hearty
congratulations to everyone who contributed. One of the interesting
things about doing all these conversions is the amount of conversation
it has started about our conventions, and I'm pleased to see that we're
really starting to get a feel for how RST can work for us, and what we
can demand of it. It's also great to see some related changes to the
sphinx theme that handles how we display our shiny RST books.

== Progress towards Liberty ==

75 days to go!

== RST Migration ==

The next books we are focusing on for RST conversion are the Install
Guide, Cloud Admin Guide, HA Guide, and the Security Guide. If you would
like to assist, please get in touch with the appropriate speciality team:

For books that are now being converted, don't forget that any change you
make to the XML must also be made to the RST version until conversion is
complete. Our lovely team of cores will be keeping an eye out to make
sure loose changes to XML don't pass the gate, but try to help them out
by pointing out both patches in your reviews.

== Docs Tools ==

Thanks to Dave for picking up a bug this week and adding a navigation
bar to the sidepane of the docs theme for our RST books. We should be
releasing an updated docs theme shortly so you can play with this new
functionality. In the meantime, if you have suggestions for the docs
theme, raise the issue on the docs mailing list, or go right ahead and
create a bug for it.

== APAC Docs Swarm ==

The APAC team have been working on holding another doc swarm, this time
working on the Architecture Design Guide. It's to be held at the Red Hat
office in Brisbane, on 13-14 August. Check out for all the info.

== Doc team meeting ==

The US meeting got cancelled this week.

The next meetings are:
APAC: Wednesday 5 August, 00:30:00 UTC
US: Wednesday 12 August, 14:00:00 UTC

Please go ahead and add any agenda items to the meeting page here:

== Spotlight bugs for this week ==

Three new spotlight bugs for you to sink your teeth into: VPNaaS isn't
documented in cloud admin VMware: add
support for VM diagnostics Document nova
server package

Remember, if you have content you would like to add to this newsletter,
or you would like to be added to the distribution list, please email me
directly at, or visit:

Keep on doc'ing!


Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
Version: GnuPG v1


OpenStack Development Mailing List (not for usage questions)
asked Jul 31, 2015 in openstack-docs by Lana_Brindley (6,210 points)   2 3 3