The Docs workflow (`links` job) is a required status check, but its trigger was `paths:`-filtered to markdown/docs files. A PR touching only code never triggered it, so the required check never reported and the merge box stayed BLOCKED forever waiting for a status that would never arrive. Drop the `paths:` filter: `make docs-check` validates the whole doc tree independent of the PR diff and runs in seconds, so it is cheap to report on every PR. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
28 lines
714 B
YAML
28 lines
714 B
YAML
name: Docs
|
|
|
|
# Runs on EVERY pull request / push to main — no `paths:` filter. When `links`
|
|
# is a required status check, path-filtering it silently blocks code-only PRs:
|
|
# the workflow is skipped, the required check never reports, and the merge box
|
|
# waits forever. `make docs-check` validates the whole doc tree regardless of
|
|
# what a PR touched and takes only seconds, so it is cheap to always report.
|
|
on:
|
|
pull_request:
|
|
push:
|
|
branches: [main]
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
concurrency:
|
|
group: docs-${{ github.ref }}
|
|
cancel-in-progress: true
|
|
|
|
jobs:
|
|
links:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@v6
|
|
|
|
- name: Validate Markdown docs
|
|
run: make docs-check
|