Files
EverOS/.github/workflows/docs.yml
T
zhanghuiandClaude Opus 4.8 e85db903a2 ci(docs): run docs check on every PR so its required check reports
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>
2026-07-24 16:12:59 +08:00

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