name: CI / Documentation

on:
  pull_request:
    branches: [main]
    paths:
      - '.github/workflows/ci-docs.yml'
      - '.github/workflows/_build-docs.yml'
      - 'AGENTS.md'
      - 'README.md'
      - 'README_ZH.md'
      - 'docs/**'
      - 'github-pages/**'
      - 'reme/config/default.yaml'
      - 'integrations/claude_code/README.md'
      - 'integrations/hermes_agent/README.md'
      - 'reme_studio/README*.md'
      - 'reme_studio/public/og.jpg'
      - 'integrations/dsh/README*.md'
      - 'integrations/dsh/figures/**'
      - 'integrations/openclaw/README*.md'
      - 'plugins/*/README*.md'
      - 'benchmark/*/README*.md'
      - 'benchmark/toolmemory/gitcha.png'
  workflow_dispatch:

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

permissions:
  contents: read

jobs:
  documentation:
    name: Test and build documentation
    uses: ./.github/workflows/_build-docs.yml
    with:
      run_tests: true