fix tox -e docs errors

Change-Id: I516e28cefbfe041085a547ed9b601c3aa1541ce8

doc/source/howtos/multiple-pools.rst

@@ -206,7 +206,7 @@ For example, if we wanted to allow a user to select a specific pool by
 id or fallback to using a default, we could use the following
 configuration.
 
-.. code-block:: conf
+.. code-block:: ini
 
    [service:central]
    default_pool_id = 794ccc2c-d751-44fe-b57f-8894c9f5c842
@@ -224,7 +224,7 @@ Schedule by Tier Example
 In our tiered example, we'll use the `attribute` filter to select the
 correct pool.
 
-.. code-block:: conf
+.. code-block:: ini
 
    [service:central]
    default_pool_id = 794ccc2c-d751-44fe-b57f-8894c9f5c842  # the std pool

doc/source/howtos/tlds.rst

@@ -56,7 +56,7 @@ Response:
    "updated_at": null,
    "id": "cfee7486-7ce4-4851-9c38-7b0fe3d42ee9",
    "description": "tld description"
-}
+  }
 
 
 Now, if someone were to try and create ``example.net.``, they would encounter

doc/source/index.rst

@@ -92,6 +92,7 @@ Developer Documentation
     devstack
     functional-tests
     tempest
+    related
 
 Indices and tables
 ==================

doc/source/metrics.rst

@@ -1,15 +1,14 @@
 .. _metrics:
 
-****
+*******
 metrics
-****
+*******
 
 metrics Base
-=========
+============
 .. automodule:: designate.metrics
     :members:
     :special-members:
     :private-members:
     :undoc-members:
     :show-inheritance:
-

doc/source/tempest.rst

@@ -215,7 +215,7 @@ to explain their purpose and correct usage.
 
 
 @decorators.idempotent_id
-~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The `idempotent_id` decorator allows for tracking of tests even after they have
 been renamed. The UUID should be randomly generated as the test is first