Add makefile items

Author: adamtheturtle

Makefile

@@ -1,5 +1,8 @@
 SHELL := /bin/bash -euxo pipefail
 
+# Treat Sphinx warnings as errors
+SPHINXOPTS := -W
+
 .PHONY: lint
 lint:
 	check-manifest .
@@ -41,3 +44,13 @@ fix-lint:
 	    --exclude src/vws/_version.py \
 	    .
 	isort --recursive --apply
+
+.PHONY: docs
+docs:
+	make -C docs clean html SPHINXOPTS=$(SPHINXOPTS)
+
+.PHONY: open-docs
+open-docs:
+	xdg-open docs/build/html/index.html >/dev/null 2>&1 || \
+	open docs/build/html/index.html >/dev/null 2>&1 || \
+	echo "Requires 'xdg-open' or 'open' but neither is available."

docs/source/conf.py

@@ -9,16 +9,14 @@
 import os
 import sys
 
-import mock_vws
+import vws
 
 sys.path.insert(0, os.path.abspath('.'))
 
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.intersphinx',
     'sphinx.ext.napoleon',
-    'sphinx_autodoc_typehints',
-    'sphinxcontrib.spelling',
 ]
 
 templates_path = ['_templates']