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/sphinx_conf/linkcheck_ignore.py b/sphinx_conf/linkcheck_ignore.py
index d4cb09c..1bae87b 100644
--- a/sphinx_conf/linkcheck_ignore.py
+++ b/sphinx_conf/linkcheck_ignore.py
@@ -109,6 +109,11 @@
     r'.*/_static/cord-tester/.*',
     r'.*/_static/voltha-system-tests/.*',
 
+    # Some docs were not correctly deployed, creating a cycle where new docs
+    # can't be generated because of link failures. We therefore need to
+    # temporarily stop all linkchecks against docs.voltha.org.
+    r'https://docs.voltha.org/.*',
+
     ])
 
 # [SEE ALSO]