docs.yml

name: Docs

# Cloudflare Pages deploy is disabled for now — docs hosting is moving to a
# different approach. This workflow is manual-only (workflow_dispatch) and just
# builds the site as a check; the CI workflow already validates the docs build
# (strict), examples, prose, and links on every push. Re-add a deploy step here
# (or a new workflow) once the new hosting path is decided.
on:
  workflow_dispatch:

permissions:
  contents: read

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6

      - name: Install uv
        uses: astral-sh/setup-uv@v8.2.0

      - name: Set up Python
        run: uv python install 3.13

      - name: Install dependencies
        run: uv sync --group docs

      - name: Install d2
        run: curl -fsSL https://d2lang.com/install.sh | sh -s --

      - name: Build docs
        run: uv run mkdocs build --strict