Build documentation with sphinx

This is basically copied verbatim from azafea. The only missing part is
the Read the Docs integration.

Author: dbnicholson

.dockerignore

@@ -9,4 +9,3 @@
 /build
 /dist
 /Dockerfile
-/docs

.github/workflows/tests.yml

@@ -54,6 +54,21 @@ jobs:
       - name: Lint and Type Checking
         run: docker run --rm --entrypoint="" amp pipenv run lint
 
+  doc:
+    name: Documentation Building Test
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Get Docker Image
+        uses: actions/download-artifact@v2
+        with:
+          name: image
+      - name: Load Docker Image
+        run: docker load < docker-image.tar
+      - name: Build Documentation
+        run: docker run --rm --entrypoint="" --user=0:0 amp pipenv run doc -nW --keep-going
+
   push:
     name: Upload the Docker image to Docker Hub
     runs-on: ubuntu-latest

Pipfile

@@ -10,6 +10,7 @@ pytest-aiohttp = "~= 0.3"
 pytest-cov = "*"
 pytest-flake8 = "*"
 pytest-mypy = ">=0.3.3"
+sphinx = "*"
 
 [packages]
 aiohttp = ">= 3.5.0"
@@ -18,6 +19,7 @@ pydantic = "~= 1.1"
 toml = "*"
 
 [scripts]
+doc = "sphinx-build -b html docs/source docs/build/html"
 lint = "py.test --flake8 --mypy -m 'flake8 or mypy'"
 proxy = "python -m azafea_metrics_proxy"
 test = "py.test --cov=azafea_metrics_proxy --cov-fail-under=99 --no-cov-on-fail -m 'not integration'"