OpenStack Liberty Installation Guide: RST Conversion¶

Problem description¶

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.

Proposed change¶

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 extension.

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
• ubuntu: Ubuntu

Plan for Debian install guide will be addressed in a separate spec.

Implementation¶

Dependencies¶

The main dependency is on docs.openstack.org infrastructure updates.

Testing¶

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.

References¶

• Discussion can occur using any official medium including IRC in #openstack-doc, the openstack-docs mailing list with [install-guide] in the subject, weekly Installation Guide specialty team meeting, weekly documentation team meeting, and potentially etherpads.