Cleanup

- Use doc8 to check rst files
- Add spellcheck and VOLTHA-specific dictionary, fix spelling
- Other formatting and content fixes

Change-Id: I1eea3ab6eba4ec34af0788a681f1e8cd258ea988
diff --git a/index.rst b/index.rst
index bd1a3da..dc0c21e 100644
--- a/index.rst
+++ b/index.rst
@@ -10,6 +10,7 @@
    :caption: Overview
 
    overview/deploy-physical.rst
+   overview/physical_layout.rst
    overview/deploy-virtual.rst
    overview/development_loop.rst
    overview/troubleshooting.rst
@@ -23,9 +24,6 @@
    voltha-go/README.md
    voltha-go/quickstart.md
    voltha-go/BUILD.md
-   voltha-go/python/adapters/BUILD_ENV.md
-   voltha-go/python/adapters/README.md
-   voltha-go/python/cli/docs/README.md
 
 .. toctree::
    :maxdepth: 1