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/lint/fix-errors/yamllint/long-lines.rst b/howto/code/lint/fix-errors/yamllint/long-lines.rst
index e4d16bf..2368905 100644
--- a/howto/code/lint/fix-errors/yamllint/long-lines.rst
+++ b/howto/code/lint/fix-errors/yamllint/long-lines.rst
@@ -12,4 +12,4 @@
 
 .. seealso::
 
-- https://yaml-multiline.info/
+   - https://yaml-multiline.info/