Resolve Vale errors, lint pydoc too

build-docs.sh

 python docs/dump-openapi-spec.py
 
 sphinx-apidoc lso lso/app.py -o docs/source -d 2 -f
+vale --config=docs/vale/.vale.ini docs/source/*.rst lso/*.py
 sphinx-build -b html docs/source docs/build

docs/source/quickstart.rst

-Quick Start
+Quick start
 ==================
 
 *This is a quick setup guide for running standalone on your local machine*
 
-Install the Module
+Install the module
 --------------------
 
 *One of these should be what you're looking for:*
@@ -31,7 +31,7 @@ Install the Module
     # for a full dev environment
     pip install -r requirements.txt
 
-Running the App
+Running the app
 -------------------
 
 * Create a settings file, see `config.json.example` for an example.

docs/vale/.vale.ini

@@ -9,5 +9,5 @@ Packages = proselint, Microsoft
 [*]
 BasedOnStyles = Vale, proselint, Microsoft
 
-; Ignore the table of contents directive
-BlockIgnores = (?s) *(\x60\x60\x60{toctree}.*?\x60\x60\x60)
+[formats]
+py = rst

docs/vale/styles/Vocab/Sphinx/accept.txt

-toctree
+param

docs/vale/styles/Vocab/geant-jargon/accept.txt

-lso
-LSO
+[LSO|lso]
 [Ss]ubpackages

lso/__init__.py

@@ -15,7 +15,7 @@ from lso.routes import default, device
 def create_app():
     """
     overrides default settings with those found
-    in the file read from env var SETTINGS_FILENAME
+    in the file read from environment variable `SETTINGS_FILENAME`
 
     :return: a new flask app instance
     """

tox.ini

@@ -16,4 +16,7 @@ commands =
     coverage report --fail-under 80
     flake8
     python docs/dump-openapi-spec.py
+    sphinx-apidoc lso lso/app.py -o docs/source -d 2 -f
+    vale --config=docs/vale/.vale.ini sync
+    vale --config=docs/vale/.vale.ini docs/source/*.rst lso/*.py
     sphinx-build -b html docs/source docs/build