Add api-ref publish job

* Add pointers in the main doc to api-ref and releasenotes pages
* Add publish-stx-api-ref job
* Add search at bottom of api-ref and relnotes pages to trigger the jobs
* Add openstackdocstheme installation into requirements file

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

.zuul.yaml

@@ -12,4 +12,5 @@
         - openstack-tox-linters
     post:
       jobs:
+        - publish-stx-api-ref
         - publish-stx-docs

api-ref/source/index.rst

@@ -12,3 +12,4 @@ StarlingX Documentation
    api-ref-image-v2-cgcs-ext
    api-ref-networking-v2-cgcs-ext
 
+:ref:`search`

doc/requirements.txt

@@ -1,5 +1,6 @@
 openstack-doc-tools>=1.6.0
 sphinx>=1.6.2
+openstackdocstheme>=1.19.0 # Apache-2.0
 
 # API Reference Guide
 os-api-ref>=1.4.0 # Apache-2.0

doc/source/index.rst

@@ -33,6 +33,14 @@ Specs
 
    Specs <https://docs.starlingx.io/specs>
 
+API Reference
+-------------
+
+.. toctree::
+   :maxdepth: 1
+
+   API Reference <https://docs.starlingx.io/api-ref/stx-docs>
+
 Contributing
 ============