Temporary disable openapi api-ref

The world (and requriements) broke us again, not a surprise, but it is
not really sustainable anymore. requirements updated markdown-it-py
which is not supported by myst_parser (which got in limbo) which is
necessary by os-openapi to build sphinx extension. There seems to be no
fast workaround possible for that so temporary (hopefully) disable the
part of building openapi docs.

Change-Id: Idbf4901604522c2b2bafd976a6914963212def83
Signed-off-by: Artem Goncharov <artem.goncharov@gmail.com>

api-ref/requirements.txt

@@ -1,4 +1,4 @@
 # os-openapi is installed directly from git since we do not do releases (yet?)
-os-openapi @ git+https://opendev.org/openstack/openapi
+# os-openapi @ git+https://opendev.org/openstack/openapi
 
 os-api-ref>=1.4.0 # Apache-2.0

api-ref/source/conf.py

@@ -25,7 +25,7 @@
 html_theme = 'openstackdocs'
 html_theme_options = {"sidebar_dropdown": "api_ref", "sidebar_mode": "toc"}
 
-extensions = ['os_api_ref', 'openstackdocstheme', 'os_openapi']
+extensions = ['os_api_ref', 'openstackdocstheme']  # , 'os_openapi']
 
 
 # If extensions (or modules to document with autodoc) are in another directory,

api-ref/source/index.rst

@@ -10,10 +10,11 @@ Contents:
     v3/index
     v3-ext/index
 
-.. toctree::
-    :maxdepth: 1
+..
+  .. toctree ::
+     :maxdepth: 1
 
-    openapi
+     openapi
 
 Indices and tables
 ==================