Publish API reference to python.durable-workflow.com

Set up mkdocs-material + mkdocstrings to generate the public API
reference from docstrings under src/durable_workflow. GitHub Actions
builds the site on push to main and deploys to GitHub Pages. The
docs/CNAME file claims python.durable-workflow.com so the generated
site serves from the subdomain once DNS resolves.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: durable-workflow-ops

.github/workflows/docs.yml

@@ -0,0 +1,51 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/**'
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'pyproject.toml'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: docs
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install package + docs deps
+        run: pip install -e '.[docs]'
+
+      - name: Build site
+        run: mkdocs build --strict
+
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -5,4 +5,5 @@ __pycache__/
 .venv/
 dist/
 build/
+site/
 *.egg-info/

docs/CNAME

@@ -0,0 +1 @@
+python.durable-workflow.com

docs/index.md

@@ -0,0 +1,31 @@
+# Durable Workflow Python SDK
+
+API reference for [`durable-workflow`](https://pypi.org/project/durable-workflow/), the Python SDK for the Durable Workflow server. For conceptual documentation, tutorials, and the overall architecture, see the [main docs site](https://durable-workflow.com/docs/2.0/polyglot/python).
+
+## Install
+
+```bash
+pip install durable-workflow
+```
+
+With the optional Prometheus metrics recorder:
+
+```bash
+pip install 'durable-workflow[prometheus]'
+```
+
+## Quick links
+
+- **[Client](reference/client.md)** — start workflows, signal, query, update, wait for results, manage schedules.
+- **[Worker](reference/worker.md)** — poll the server for workflow and activity tasks, dispatch to registered handlers.
+- **[Workflow](reference/workflow.md)** — workflow-side primitives: `ContinueAsNew`, `StartChildWorkflow`, and the workflow decorator.
+- **[Activity](reference/activity.md)** — activity decorator and execution context.
+- **[Errors](reference/errors.md)** — typed exceptions raised by the client and worker.
+- **[Retry policy](reference/retry_policy.md)** — retry configuration for activities and workflows.
+- **[Metrics](reference/metrics.md)** — pluggable recorders, including a Prometheus adapter.
+- **[Serializer](reference/serializer.md)** — payload encoding and decoding helpers.
+- **[Sync helpers](reference/sync.md)** — blocking wrappers around the async client for scripts and tests.
+
+## Versioning
+
+This reference is generated from the `main` branch of [`durable-workflow/sdk-python`](https://github.com/durable-workflow/sdk-python) on every push. For the version installed in your project, check `durable_workflow.__version__`.

docs/reference/activity.md

@@ -0,0 +1,3 @@
+# Activity
+
+::: durable_workflow.activity

docs/reference/client.md

@@ -0,0 +1,3 @@
+# Client
+
+::: durable_workflow.client

docs/reference/errors.md

@@ -0,0 +1,3 @@
+# Errors
+
+::: durable_workflow.errors

docs/reference/metrics.md

@@ -0,0 +1,3 @@
+# Metrics
+
+::: durable_workflow.metrics

docs/reference/retry_policy.md

@@ -0,0 +1,3 @@
+# Retry policy
+
+::: durable_workflow.retry_policy

docs/reference/serializer.md

@@ -0,0 +1,3 @@
+# Serializer
+
+::: durable_workflow.serializer