[Doc] openstackdocstheme starlingxdocs theme

Enable starlingxdocs theme support for:

- Documentation
- Release Notes

Modify content to:

- Add pointers in the main doc to release notes pages.
- Add search at bottom of relese notes.

Add zuul post jobs:

- publish-stx-releasenotes

Change-Id: Ic795e9afd22838bb5452224267e600afba9de2cf
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>

.zuul.yaml

@@ -15,3 +15,4 @@
     post:
       jobs:
         - publish-stx-tox
+        - publish-stx-releasenotes

doc/requirements.txt

@@ -1,5 +1,5 @@
 sphinx>=1.6.2
-openstackdocstheme>=1.19.0 # Apache-2.0
+openstackdocstheme>=1.26.0 # Apache-2.0
 
 # Release Notes documentation
 reno>=0.1.1 # Apache2

doc/source/conf.py

@@ -82,7 +82,7 @@ pygments_style = 'sphinx'
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'alabaster'
+html_theme = 'starlingxdocs'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the

doc/source/index.rst

@@ -7,6 +7,14 @@ StarlingX Distributed Cloud Client
    :maxdepth: 2
    :caption: Contents:
 
+Release Notes
+-------------
+
+.. toctree::
+   :maxdepth: 1
+
+   Release Notes <https://docs.starlingx.io/releasenotes/stx-distcloud-client>
+
 Links
 =====
 

releasenotes/source/conf.py

@@ -93,7 +93,7 @@ pygments_style = 'sphinx'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'alabaster'
+html_theme = 'starlingxdocs'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the

releasenotes/source/index.rst

@@ -5,3 +5,5 @@ stx-distcloud-client Release Notes
    :maxdepth: 2
 
    unreleased
+
+:ref:`search`