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/readme.rst b/readme.rst
index d73f458..a0acf09 100644
--- a/readme.rst
+++ b/readme.rst
@@ -17,6 +17,10 @@
 in Jenkins to validate the documentation, so please do this before you create a
 patchset.
 
+To check spelling, run ``make spelling``. If there are additional words that
+are correctly spelled but not in the dictionary (acronyms, trademarks, etc.)
+please add them to the ``dict.txt`` file.
+
 Writing Docs
 ------------