name: Documentation Verification

on:
  push:
    branches: [main]
    paths:
      - 'docs/**'
      - '.github/workflows/docs-verify.yml'
  pull_request:
    branches: [main]
    paths:
      - 'docs/**'
      - '.github/workflows/docs-verify.yml'

env:
  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true

permissions:
  contents: read

jobs:
  docs-validate:
    name: Validate Documentation
    runs-on: ubuntu-latest
    if: github.event.pull_request.draft == false
    steps:
      - uses: actions/checkout@v5

      - name: Check docs.json references
        run: |
          echo "🔍 Validating docs.json..."
          ./scripts/check-docs-json.sh
        shell: bash