deploy-guide: fix small rst format issues

This fixes a few minor rst format issues like:
* nested lists which were shown as blockquote
* code-blocks which were show as blockquote
* underlining of titles which didn't match
* missing backslash escaping in parsed-literal

Change-Id: I9b0934112f7f26775af52b6fc7de9fd29b215998

deploy-guide/source/app-advanced-config-options.rst

@@ -1,6 +1,6 @@
-===================================
+==================================
 Appendix G: Advanced configuration
-===================================
+==================================
 
 .. TODO: include intro on what advanced configuration is, whether it’s required
    or optional, and when someone should do it

deploy-guide/source/app-advanced-config-override.rst

@@ -131,7 +131,7 @@ overrides, the general format for the variable name is
 ``<service>_policy_overrides``.
 
 Overriding .yml files
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~
 
 You can override ``.yml`` file values by supplying replacement YAML content.
 

deploy-guide/source/app-config-prod.rst

@@ -87,7 +87,7 @@ following is the ``/etc/network/interfaces`` file for ``infra1``.
 .. literalinclude:: ../../etc/network/interfaces.d/openstack_interface.cfg.prod.example
 
 Deployment configuration
-~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 Environment layout
 ------------------

deploy-guide/source/app-config-test.rst

@@ -74,7 +74,7 @@ following is the ``/etc/network/interfaces`` file for ``infra1``.
 .. literalinclude:: ../../etc/network/interfaces.d/openstack_interface.cfg.test.example
 
 Deployment configuration
-~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 Environment layout
 ------------------

deploy-guide/source/app-custom-layouts.rst

@@ -1,6 +1,6 @@
-==================================================
+================================================
 Appendix C: Customizing host and service layouts
-==================================================
+================================================
 
 The default layout of containers and services in OpenStack-Ansible (OSA) is
 determined by the ``/etc/openstack_deploy/openstack_user_config.yml`` file and

deploy-guide/source/app-resources.rst

@@ -1,6 +1,6 @@
-=================================
+================================
 Appendix I: Additional resources
-=================================
+================================
 
 Ansible resources:
 

deploy-guide/source/app-security.rst

@@ -1,6 +1,6 @@
-=====================
+====================
 Appendix D: Security
-=====================
+====================
 
 Security is one of the top priorities within OpenStack-Ansible (OSA), and many
 security enhancements for OpenStack clouds are available in deployments by

deploy-guide/source/configure.rst

@@ -58,7 +58,7 @@ configuration, see
 `developer-inventory <http://docs.openstack.org/developer/openstack-ansible/developer-docs/inventory.html>`_.
 
 Installing additional services
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To install additional services, the files in
 ``/etc/openstack_deploy/conf.d`` provide examples showing
@@ -172,10 +172,10 @@ password for both the OpenStack API and Dashboard access.
 We recommend that you use the ``pw-token-gen.py`` script to generate random
 values for the variables in each file that contains service credentials:
 
-   .. code-block:: shell-session
+.. code-block:: shell-session
 
-      # cd /opt/openstack-ansible/scripts
+   # cd /opt/openstack-ansible/scripts
-      # python pw-token-gen.py --file /etc/openstack_deploy/user_secrets.yml
+   # python pw-token-gen.py --file /etc/openstack_deploy/user_secrets.yml
 
 To regenerate existing passwords, add the ``--regen`` flag.
 

deploy-guide/source/deploymenthost.rst

@@ -68,9 +68,9 @@ Before you begin, we recommend upgrading your system packages and kernel.
 
 #. Upgrade the system packages and kernel
 
-  .. code-block:: shell-session
+   .. code-block:: shell-session
 
-      # yum upgrade
+       # yum upgrade
 
 #. Reboot the host.
 
@@ -118,7 +118,7 @@ Install the source and dependencies for the deployment host.
 
    .. parsed-literal::
 
-       # git clone -b |latest_tag| https://git.openstack.org/openstack/openstack-ansible \
+       # git clone -b |latest_tag| https://git.openstack.org/openstack/openstack-ansible \\
          /opt/openstack-ansible
 
 #. Change to the ``/opt/openstack-ansible`` directory, and run the

deploy-guide/source/overview-requirements.rst

@@ -13,15 +13,15 @@ following minimum requirements:
 
 * Ubuntu
 
- * Ubuntu 16.04 LTS (Xenial Xerus)
+  * Ubuntu 16.04 LTS (Xenial Xerus)
 
- * Linux kernel version ``3.13.0-34-generic`` or later is required.
+  * Linux kernel version ``3.13.0-34-generic`` or later is required.
 
 * CentOS (support is experimental)
 
- * Centos 7, fully updated.
+  * Centos 7, fully updated.
 
- * Linux kernel verison ``3.10.0`` or later.
+  * Linux kernel verison ``3.10.0`` or later.
 
 * Secure Shell (SSH) client and server that support public key
   authentication