OpenStack Liberty Installation Guide: RST Conversion¶
The OpenStack Installation Guide will be converted to RST. DocBook will continue to be maintained in stable/kilo.
For the Liberty time frame, the following tasks need to be accomplished for the Installation Guide:
- RST conversion
- Liberty installation updates and testing
This spec is primarily concerned with the RST conversion.
Freeze development on the Installation Guide.
Convert Installation Guide to RST, concentrating on installation of core services: nova, cinder, glance, keystone, neutron, swift.
Conditionals can be applied using
:only: or the ifconfig
Conditional tags will be simplified as much as possible, grouping content according to operating system group:
obs: openSUSE, SUSE Linux Enterprise Server
rdo: CentOS, Fedora, RHEL
Plan for Debian install guide will be addressed in a separate spec.
The main dependency is on docs.openstack.org infrastructure updates.
We need to test the new HTML design on these browsers/operating systems as a priority:
- Chrome on Ubuntu, Fedora, Mac, Windows
- Firefox on Ubuntu, Fedora, Mac, Windows
Need to test PDF output.