Skip to content

Skip CI for pull requests that only change documentation - #6127

Open
danielmarbach wants to merge 5 commits into
masterfrom
ci-skip-docs-only
Open

danielmarbach wants to merge 5 commits into
masterfrom
ci-skip-docs-only

Conversation

@danielmarbach

@danielmarbach danielmarbach commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Pull requests that only change docs/**/*.md or AGENTS.md no longer run CI.

ci.yml ignores those paths on pull_request. Because the required checks would then stay pending, the new ci-docs-skip.yml triggers on the same paths and reports every CI check name as passed. Its job names mirror ci.yml, including the reusable-workflow names such as containers / servicecontrol. ci-docs-skip.yml must be updated whenever a ci.yml job or matrix entry changes.

A pull request that changes both docs and code matches both workflows, so the shadow checks and the real checks share names. In a test with such a pull request, GitHub kept it blocked while the real jobs ran. All real and shadow checks passed once the jobs finished. A docs-only pull request ran only the shadow workflow and was mergeable.

code-analysis.yml is unchanged and still runs on docs-only pull requests.

Docs reviewed: docs/README.md, CONTRIBUTING.md, and the other pages under docs/. None describes ci.yml, so no update is needed.

@danielmarbach

Copy link
Copy Markdown
Contributor Author

See also #6128

@danielmarbach
danielmarbach marked this pull request as ready for review November 13, 2026 00:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants