Add basic Sphinx setup and brief tour documentation

Author: brandonwillard

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help venv conda docker docstyle format style black test lint check coverage
+.PHONY: help venv conda docker docstyle format style black test lint check coverage docs
 .DEFAULT_GOAL = help
 
 PYTHON = python
@@ -63,6 +63,15 @@ test:  # Test code using pytest.
 coverage: test
 	diff-cover coverage.xml --compare-branch=master --fail-under=100
 
+docs:
+	# latesttag=$(git describe --tags `git rev-list --tags --max-count=1`)
+	# echo checking out ${latesttag}
+	# git checkout ${latesttag}
+	pushd docs && \
+	make html && \
+	ghp-import -n -p -r upstream -b gh-pages build/html && \
+	popd
+
 lint: docstyle format style  # Lint code using pydocstyle, black and pylint.
 
 check: lint test coverage  # Both lint and test code. Runs `make lint` followed by `make test`.

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)