Use sphinxcontrib-openapi to do the heavy lifting of Open API rendering.

docs/api/conf.py

@@ -45,8 +45,7 @@ release = u''
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'recommonmark',
-    'sphinx.ext.autosectionlabel',
+    'sphinxcontrib.openapi',
 ]
 
 # Prefix document path to section labels, otherwise autogenerated labels would look like 'heading'
@@ -59,7 +58,7 @@ templates_path = ['_templates']
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
-source_suffix = ['.rst', '.md']
+source_suffix = ['.rst']
 
 # The master toctree document.
 master_doc = 'index'

docs/api/index.rst

@@ -7,8 +7,6 @@ TODO: What should go here?
 See all the endpoints at :doc:`The Endpoints <gen/index>`.
 
 .. toctree::
-    :glob:
-    :maxdepth: 1
+    :hidden:
 
     gen/index
-    gen/*