Prepare for Readthedocs

.github/workflows/publish-docs.yaml

@@ -0,0 +1,37 @@
+name: Publish new Docs
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_run:
+    workflows: ["Python Tests", "Publish to PyPI"]
+    types:
+      - completed
+    branches: [main]
+
+jobs:
+  docs:
+    name: Build documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: "3.10"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+          pip install sphinx sphinx-rtd-theme sphinx-autodoc-typehints sphinx-copybutton myst-parser
+      - name: Build documentation
+        run: |
+          cd docs
+          make html
+      - name: Archive documentation
+        uses: actions/upload-artifact@v2
+        with:
+          name: documentation
+          path: docs/build/html/

.github/workflows/publish-to-test-pypi.yml

@@ -1,4 +1,4 @@
-name: Publish Python distribution to PyPI and TestPyPI
+name: Publish to PyPI
 
 on:
   push:

.readthedocs.yaml

@@ -0,0 +1,27 @@
+# Read the Docs configuration file for pyUSPTO
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html
+
+version: 2
+
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.10"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/source/conf.py
+
+# Optionally declare the Python requirements required to build your docs
+python:
+  install:
+    - requirements: requirements.txt
+    - requirements: requirements-dev.txt
+    - method: pip
+      path: .
+
+# Optional but recommended, declare the formats you want to build
+formats:
+  - pdf
+  - htmlzip