[OpenStack-docs] [config-ref] RST migration status and next steps

Gauvain Pocentek gauvain.pocentek at objectif-libre.com
Wed Nov 11 06:18:23 UTC 2015


Hi all,

Here's what happened since the summit:

- the migration spec has been accepted: 
http://specs.openstack.org/openstack/docs-specs/specs/mitaka/config-ref-rst.html
- the initial structure for the RST version is in place: 
https://github.com/openstack/openstack-manuals/tree/master/doc/config-ref-rst
- we even have a couple sections migrated!
- the config tables generation tools are being updated to support RST 
output (https://review.openstack.org/#/c/243788/ and 
https://review.openstack.org/#/c/243769/)

I'd like to generate all the RST tables ASAP, but we first need to have 
the liberty branching set up, otherwise it will be a mess to handle 
possible updates of tables on the liberty stable branch (remember, the 
config-ref is versioned).

In the meantime feel free to convert the sections which do not include 
these tables, and don't forget to update 
https://wiki.openstack.org/wiki/Documentation/Migrate#Configuration_Reference_Guide_Migration 
to let the others know on which files you're working.

Thanks,

Gauvain



More information about the OpenStack-docs mailing list