Clean up docs issues
The Sphinx build produces a number of warnings and errors. Some are
rightfully ignored, but many need to be fixed. These are mostly
unindexed pages and misformatted references.
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
Change-Id: I9d7a116dc87083ad2dcab20e31cd479364f298cd
diff --git a/howto/code/linting.rst b/howto/code/linting.rst
index 5bf8524..7fd223e 100644
--- a/howto/code/linting.rst
+++ b/howto/code/linting.rst
@@ -58,9 +58,9 @@
.. seealso::
-- :ref:`Makefile Target lint-chart`
-- :ref:`Makefile Target lint-helm`
-- :ref:`Makefile Target lint-robot`
+ - :ref:`Makefile Target lint-chart`
+ - :ref:`Makefile Target lint-helm`
+ - :ref:`Makefile Target lint-robot`
|
@@ -166,8 +166,6 @@
--------
- lint-doc8-all target dependency will create a `python virtual env <https://wiki.opencord.org>`_
-- python 3.10+ requires `virtual env patching <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/patches/>`_ (dynamic, applied when needed).
-- `makefiles/patches/include.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles-orig/patches/>`__
|
@@ -192,8 +190,6 @@
Notes:
- lint-flake8-all target dependency will create a `python virtual env <https://wiki.opencord.org>`_
-- python 3.10+ requires `virtual env patching <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/patches/>`_ (dynamic, applied when needed).
-- `makefiles/patches/include.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles-orig/patches/>`__
|
@@ -269,7 +265,6 @@
- pylint the --py3k option is no longer supported by v3.10+
- lint-pylint-all target dependency will create a `python virtual env <https://wiki.opencord.org>`_
-- python 3.10+ requires `virtual env patching <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/patches/>`_ (dynamic, applied when needed).
|