d-OAuth-Server/.github/workflows/docs.yml

# Documentation quality gate (task 48).
#
# Runs the local link checker over README.md, AGENTS.md, SECURITY.md, and
# docs/*.md so a stale file or heading reference fails CI. This is the "markdown-link-check
# equivalent" named by the task; it is deliberately offline (only relative
# links are validated) so the job needs no network beyond checkout/setup.
#
# Task 42 owns the main CI workflow. This job is intentionally a separate
# workflow file so it can be added to that pipeline as a required step
# (`docs` job name) without a conflict, and it also runs standalone.
name: docs

on:
  push:
    paths:
      - "README.md"
      - "AGENTS.md"
      - "SECURITY.md"
      - "docs/**"
      - "scripts/check_doc_links.py"
      - ".github/workflows/docs.yml"
  pull_request:
    paths:
      - "README.md"
      - "AGENTS.md"
      - "SECURITY.md"
      - "docs/**"
      - "scripts/check_doc_links.py"
      - ".github/workflows/docs.yml"
  workflow_dispatch: {}

permissions:
  contents: read

jobs:
  link-check:
    name: docs link-check
    runs-on: ubuntu-24.04
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
        with:
          python-version: "3.x"
      - name: Check documentation links
        run: python3 scripts/check_doc_links.py