check-docs.yml

name: Docs

on: [push, pull_request]

concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
  cancel-in-progress: true

jobs:
  pre_job:
    name: Path match check
    runs-on: ubuntu-latest
    # Map a step output to a job output
    outputs:
      should_skip: ${{ steps.skip_check.outputs.should_skip }}
    steps:
      - id: skip_check
        uses: fkirc/skip-duplicate-actions@master
        with:
          github_token: ${{ github.token }}
          paths: '["docs/**", "pyproject.toml", "uv.lock"]'

  docs:
    name: Checking docs build
    needs: pre_job
    if: ${{ needs.pre_job.outputs.should_skip != 'true' }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7.0.1
        with:
          fetch-depth: 0
      - name: Install system dependencies
        run: |
          sudo apt-get -y -qq update
          sudo apt-get install -y swig openssl libssl-dev
      - name: Install uv
        uses: astral-sh/setup-uv@v8.2.0
        with:
          python-version: "3.10"
          activate-environment: "true"
          enable-cache: "true"
      - name: Install dependencies
        run: uv sync --frozen --group docs
      - name: Check Docs build
        run: make docs