Adds doc8 check to pep8

This patch adds doc8 check for .rst files to pep8.
Files that fail doc8 check are also fixed.

Ignore D001 of doc8 check. This requires lot of changes and
should be done in a separated patch.

Change-Id: I7732abc55ec27026efbf56663ba02ff27e8ec847

11 files changed, 80 insertions, 79 deletions

diff --git a/doc/source/configuration/config-options.rst b/doc/source/configuration/config-options.rst
index 3a00c03a5..87a6e1caa 100644
--- a/doc/source/configuration/config-options.rst
+++ b/doc/source/configuration/config-options.rst
@@ -2,7 +2,8 @@
 Configuration options for the Orchestration service
 ===================================================
 
-The following options can be set in the ``/etc/heat/heat.conf`` config file. A :doc:`sample configuration file <sample_config>` is also available.
+The following options can be set in the ``/etc/heat/heat.conf`` config file.
+A :doc:`sample configuration file <sample_config>` is also available.
 
 .. show-options::
    :config-file: config-generator.conf
diff --git a/doc/source/developing_guides/rally_on_gates.rst b/doc/source/developing_guides/rally_on_gates.rst
index 41096b1be..91ece0533 100644
--- a/doc/source/developing_guides/rally_on_gates.rst
+++ b/doc/source/developing_guides/rally_on_gates.rst
@@ -34,10 +34,10 @@ https://github.com/openstack/heat/blob/master/rally-scenarios/heat-fakevirt.yaml
 Obviously performance analysis make sense, when it can be compared with some
 another performance data. So two different approaches can be used for it:
 
- - Comparison of one part of code with some custom changes
-   (see :ref:`check_performance_or_detect_regression`)
- - Comparison of two different code parts
-   (see :ref:`compare_output_API_performance`)
+- Comparison of one part of code with some custom changes
+  (see :ref:`check_performance_or_detect_regression`)
+- Comparison of two different code parts
+  (see :ref:`compare_output_API_performance`)
 
 Examples of using Rally
 -----------------------
@@ -118,10 +118,10 @@ that caching works correct.
 Also this approach may be used for detecting regressions. In this case workflow
 may be presented as follow list of steps:
 
- - add to task list (``heat-fakevirt.yaml``) existing or new tasks.
- - wait a result of this execution.
- - upload patchset with changes (new feature) and launch the same test again.
- - compare performance results.
+- add to task list (``heat-fakevirt.yaml``) existing or new tasks.
+- wait a result of this execution.
+- upload patchset with changes (new feature) and launch the same test again.
+- compare performance results.
 
 .. _compare_output_API_performance:
 
diff --git a/doc/source/getting_started/on_devstack.rst b/doc/source/getting_started/on_devstack.rst
index 666683f28..8d8412c81 100644
--- a/doc/source/getting_started/on_devstack.rst
+++ b/doc/source/getting_started/on_devstack.rst
@@ -33,7 +33,7 @@ Newer versions of OpenStack require enabling heat services in devstack
   #Enable heat services
   enable_service h-eng h-api h-api-cfn h-api-cw
 
-Since Newton release, heat is available as a devstack plugin. To enable the 
+Since Newton release, heat is available as a devstack plugin. To enable the
 plugin add the following to the `[[local|localrc]]` section of `local.conf`::
 
   [[local|localrc]]
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 4ff8e79ab..8b65d3bb8 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -24,8 +24,8 @@ Heat's purpose and vision
   application by executing appropriate :term:`OpenStack` API calls to generate
   running cloud applications.
 * A Heat template describes the infrastructure for a cloud application in text
-  files which are readable and writable by humans, and can be managed by version
-  control tools.
+  files which are readable and writable by humans, and can be managed by
+  version control tools.
 * Templates specify the relationships between resources (e.g. this
   volume is connected to this server). This enables Heat to call out to the
   OpenStack APIs to create all of your infrastructure in the correct order to
@@ -36,8 +36,8 @@ Heat's purpose and vision
   functionality such as instance high availability, instance autoscaling, and
   nested stacks.
 * Heat primarily manages infrastructure, but the templates
-  integrate well with software configuration management tools such as Puppet and
-  Ansible.
+  integrate well with software configuration management tools such as Puppet
+  and Ansible.
 * Operators can customise the capabilities of Heat by installing plugins.
 
 This documentation offers information aimed at end-users, operators and
diff --git a/doc/source/install/install-obs.rst b/doc/source/install/install-obs.rst
index 436ad8db2..69f59f484 100644
--- a/doc/source/install/install-obs.rst
+++ b/doc/source/install/install-obs.rst
@@ -327,7 +327,7 @@ Install and configure components
 
    * In the ``[database]`` section, configure database access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [database]
         ...
@@ -339,7 +339,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section,
      configure ``RabbitMQ`` message queue access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
@@ -352,7 +352,7 @@ Install and configure components
      and ``[clients_keystone]`` sections,
      configure Identity service access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [keystone_authtoken]
         ...
@@ -384,7 +384,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section, configure the metadata and
      wait condition URLs:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
@@ -394,7 +394,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section, configure the stack domain and
      administrative credentials:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
diff --git a/doc/source/install/install-rdo.rst b/doc/source/install/install-rdo.rst
index 816cc23ac..91fdd56fe 100644
--- a/doc/source/install/install-rdo.rst
+++ b/doc/source/install/install-rdo.rst
@@ -327,7 +327,7 @@ Install and configure components
 
    * In the ``[database]`` section, configure database access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [database]
         ...
@@ -339,7 +339,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section,
      configure ``RabbitMQ`` message queue access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
@@ -352,7 +352,7 @@ Install and configure components
      and ``[clients_keystone]`` sections,
      configure Identity service access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [keystone_authtoken]
         ...
@@ -384,7 +384,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section, configure the metadata and
      wait condition URLs:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
@@ -394,7 +394,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section, configure the stack domain and
      administrative credentials:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
diff --git a/doc/source/install/install-ubuntu.rst b/doc/source/install/install-ubuntu.rst
index 1c76841bc..004165083 100644
--- a/doc/source/install/install-ubuntu.rst
+++ b/doc/source/install/install-ubuntu.rst
@@ -326,7 +326,7 @@ Install and configure components
 
    * In the ``[database]`` section, configure database access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [database]
         ...
@@ -338,7 +338,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section,
      configure ``RabbitMQ`` message queue access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
@@ -351,7 +351,7 @@ Install and configure components
      ``[clients_keystone]`` sections,
      configure Identity service access:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [keystone_authtoken]
         ...
@@ -383,7 +383,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section, configure the metadata and
      wait condition URLs:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
@@ -393,7 +393,7 @@ Install and configure components
    * In the ``[DEFAULT]`` section, configure the stack domain and
      administrative credentials:
 
-     .. code-block:: none
+     .. code-block:: ini
 
         [DEFAULT]
         ...
diff --git a/doc/source/man/heat-api-cfn.rst b/doc/source/man/heat-api-cfn.rst
index 9d3b51de5..005217cd6 100644
--- a/doc/source/man/heat-api-cfn.rst
+++ b/doc/source/man/heat-api-cfn.rst
@@ -30,7 +30,7 @@ OPTIONS
 
   Path to a config directory to pull .conf files from. This file set is
   sorted, so as to provide a predictable parse order if individual options are
-  over-ridden. The set is parsed after the file(s), if any, specified via 
+  over-ridden. The set is parsed after the file(s), if any, specified via
   --config-file, hence over-ridden options in the directory take precedence.
 
 .. cmdoption:: --version
diff --git a/doc/source/man/heat-api.rst b/doc/source/man/heat-api.rst
index b03892cfc..21b1ea7f4 100644
--- a/doc/source/man/heat-api.rst
+++ b/doc/source/man/heat-api.rst
@@ -30,7 +30,7 @@ OPTIONS
 
   Path to a config directory to pull .conf files from. This file set is
   sorted, so as to provide a predictable parse order if individual options are
-  over-ridden. The set is parsed after the file(s), if any, specified via 
+  over-ridden. The set is parsed after the file(s), if any, specified via
   --config-file, hence over-ridden options in the directory take precedence.
 
 .. cmdoption:: --version
diff --git a/doc/source/templates/cfn/WordPress_Single_Instance.rst b/doc/source/templates/cfn/WordPress_Single_Instance.rst
index e7722eb90..098491c20 100644
--- a/doc/source/templates/cfn/WordPress_Single_Instance.rst
+++ b/doc/source/templates/cfn/WordPress_Single_Instance.rst
@@ -30,37 +30,37 @@ Parameters
 ----------
 
 *KeyName* :mod:`(required)`
-	*type*
-		*string*
-	*description*
-		Name of an existing EC2 KeyPair to enable SSH access to the instance
+    *type*
+        *string*
+    *description*
+        Name of an existing EC2 KeyPair to enable SSH access to the instance
 *InstanceType* :mod:`(optional)`
-	*type*
-		*string*
-	*description*
-		The EC2 instance type
+    *type*
+        *string*
+    *description*
+        The EC2 instance type
 *DBName* :mod:`(optional)`
-	*type*
-		*string*
-	*description*
-		The WordPress database name
+    *type*
+        *string*
+    *description*
+        The WordPress database name
 *DBUsernameName* :mod:`(optional)`
-	*type*
-		*string*
-	*description*
-		The WordPress database admin account username
+    *type*
+        *string*
+    *description*
+        The WordPress database admin account username
 *DBPassword* :mod:`(optional)`
-	*type*
-		*string*
-	*description*
-		The WordPress database admin account password
+    *type*
+        *string*
+    *description*
+        The WordPress database admin account password
 *DBRootPassword* :mod:`(optional)`
-	*type*
-		*string*
-	*description*
-		Root password for MySQL
+    *type*
+        *string*
+    *description*
+        Root password for MySQL
 *LinuxDistribution* :mod:`(optional)`
-	*type*
-		*string*
-	*description*
-		Linux distribution of choice
+    *type*
+        *string*
+    *description*
+        Linux distribution of choice
diff --git a/doc/source/templates/hot/hello_world.rst b/doc/source/templates/hot/hello_world.rst
index 265867982..3e1c0a331 100644
--- a/doc/source/templates/hot/hello_world.rst
+++ b/doc/source/templates/hot/hello_world.rst
@@ -28,27 +28,27 @@ Parameters
 ----------
 
 *key_name* :mod:`(required)`
-	*type*
-		*string*
-	*description*
-		Name of an existing key pair to use for the instance
+    *type*
+        *string*
+    *description*
+        Name of an existing key pair to use for the instance
 *flavor* :mod:`(optional)`
-	*type*
-		*string*
-	*description*
-		Flavor for the instance to be created
+    *type*
+        *string*
+    *description*
+        Flavor for the instance to be created
 *image* :mod:`(required)`
-	*type*
-		*string*
-	*description*
-		Image *ID* or image name to use for the instance
+    *type*
+        *string*
+    *description*
+        Image *ID* or image name to use for the instance
 *admin_pass* :mod:`(required)`
-	*type*
-		*string*
-	*description*
-		The admin password for the instance
+    *type*
+        *string*
+    *description*
+        The admin password for the instance
 *db_port* :mod:`(optional)`
-	*type*
-		*number*
-	*description*
-		The database port number
+    *type*
+        *number*
+    *description*
+        The database port number