diff --git a/doc/source/index.rst b/doc/source/index.rst
index a1d3d0a..069202a 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -4,10 +4,15 @@
 OpenStack StarlingX Project Plans
 =================================
 
-Specifications
-==============
+Learn more about StarlingX project specifications for specific relseases
+and the process to submit a specification.
 
-Here you can find the specs, and spec template, for each release:
+Specification content can be searched using the :ref:`search page <search>`.
+
+Specifications
+--------------
+
+Here you can find the specs and spec template for each release:
 
 .. toctree::
    :glob:
@@ -16,7 +21,7 @@ Here you can find the specs, and spec template, for each release:
    specs/2019.03/index
 
 Process
-=======
+-------
 
 Documentation for stx-specs process:
 
@@ -27,8 +32,3 @@ Documentation for stx-specs process:
 
 For more details, look at spec template for the specific release, and see the
 wiki page on Blueprints: https://wiki.openstack.org/wiki/Blueprints
-
-Indices and tables
-==================
-
-* :ref:`search`
diff --git a/specs/instructions.rst b/specs/instructions.rst
index c02ffb5..186a11c 100644
--- a/specs/instructions.rst
+++ b/specs/instructions.rst
@@ -10,9 +10,12 @@
 
 .. _instructions:
 
-============
+=============
+Submit a Spec
+=============
+
 Instructions
-============
+------------
 
 - Use STX_Example_Spec.rst under the ``approved`` subfolder of the applicable
   release as the basis of your specification.