[docs] Resolve some warnings in the docs

ai4os · Sep 27, 2023 · 1f3d2f8 · 1f3d2f8
1 parent 62e6e25
commit 1f3d2f8
Show file tree

Hide file tree

Showing 4 changed files with 7 additions and 4 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -136,7 +136,7 @@ Before you submit a pull request, check that it meets these guidelines:
 
 Tox uses `py.test` under the hood, hence it supports the same syntax for selecting tests.
 
-For further information please consult the `pytest usage docs`_.
+For further information please consult the [pytest usage docs](https://docs.pytest.org/en/latest/usage.html#specifying-tests-selecting-tests).
 
 To run a particular test class with tox::
 

diff --git a/doc/source/cli/deepaas-predict.rst b/doc/source/cli/deepaas-predict.rst
@@ -1,6 +1,6 @@
-===========
+================
 deepaas-predict
-===========
+================
 
 Synopsis
 ========

diff --git a/doc/source/cli/index.rst b/doc/source/cli/index.rst
@@ -5,4 +5,6 @@ Available commands
 .. toctree::
    :maxdepth: 1
 
-   *
+   deepaas-cli
+   deepaas-predict
+   deepaas-run
diff --git a/doc/source/conf.py b/doc/source/conf.py
@@ -37,6 +37,7 @@
               'oslo_config.sphinxconfiggen',
               'oslo_config.sphinxext',
               "reno.sphinxext",
+              "recommonmark",
 ]
 
 # Add any paths that contain templates here, relative to this directory.