Improve module documentation and doc cleanup.

This adds lots of config module documentation in a standard format.
It will greatly improve the content at readthedocs.
Additionally:
 * Add a 'doc' env to tox.ini
 * Changed default highlight language for sphinx conf from python to yaml
   most examples in documentation are yaml configs
 * Updated datasource examples to highlight sh code properly

1 files changed, 6 insertions, 0 deletions

diff --git a/tox.ini b/tox.ini
index e7a6f22c..9424ae51 100644
--- a/tox.ini
+++ b/tox.ini
@@ -28,3 +28,9 @@ setenv =
 [flake8]
 ignore=H404,H405,H105,H301,H104,H403,H101
 exclude = .venv,.tox,dist,doc,*egg,.git,build,tools
+
+[testenv:doc]
+basepython = python3
+deps = {[testenv]deps}
+       sphinx
+commands = {envpython} -m sphinx {posargs:doc/rtd doc/rtd_html}