Host docs

.github/workflows/preview.yml

@@ -0,0 +1,27 @@
+name: Deploy PR previews
+
+on:
+  pull_request:
+
+concurrency: preview-${{ github.ref }}
+
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install and build
+        run: |
+          pip install -r requirements.txt
+          make html
+
+      - name: Deploy preview
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: ./_build/html

.gitignore

@@ -0,0 +1 @@
+_build/

requirements.txt

@@ -1,3 +1,10 @@
 sphinx-design
-dask-sphinx-theme
+dask-sphinx-theme>=3
 sphinx
+# FIXME: `sphinxcontrib-*` pins are a workaround until we have sphinx>=5.
+#        See https://github.com/dask/dask-sphinx-theme/issues/68.
+sphinxcontrib-applehelp>=1.0.0,<1.0.7
+sphinxcontrib-devhelp>=1.0.0,<1.0.6
+sphinxcontrib-htmlhelp>=2.0.0,<2.0.5
+sphinxcontrib-serializinghtml>=1.1.0,<1.1.10
+sphinxcontrib-qthelp>=1.0.0,<1.0.7