pr_docs_changes.yaml

# Workflow that runs on code changes to a pull request.

name: Docs changes
on:
  pull_request:
    branches:
      - main

    paths:
      - docs/**
      - .github/**
  workflow_dispatch:

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}

jobs:
  Test:
    runs-on: ubuntu-latest
    name: Test documentation builds
    timeout-minutes: 30
    steps:
      - name: Checkout repo
        uses: actions/checkout@v6
      - name: Install uv
        uses: astral-sh/setup-uv@v8.1.0
        with:
          version: "0.12.14"
      - name: Set up Python
        uses: actions/setup-python@v6
        with:
          python-version: '3.13'
      - name: Set up Quarto
        uses: quarto-dev/quarto-actions/setup@v2
      - name: Test reference generator smoke build
        run: make docs-reference-smoke
      - name: Test documentation builds
        run: make docs