Skip to content

ci: do not run the suite for a documentation-only change - #229

Merged
thedancingdeveloper merged 1 commit into
mainfrom
ci/skip-the-suite-for-docs
Aug 6, 2026
Merged

ci: do not run the suite for a documentation-only change#229
thedancingdeveloper merged 1 commit into
mainfrom
ci/skip-the-suite-for-docs

Conversation

@thedancingdeveloper

Copy link
Copy Markdown
Contributor

A docs commit was costing the same ~10 minutes as a code change.

lint and test are required checks, so they cannot be skipped — a required check that never reports blocks the PR permanently. Both jobs still run and report; a changes job decides whether they do the expensive part.

The filter is biased towards running: an unrecognised path counts as code, and pushes to main always run everything.

This PR itself touches .github/workflows/, so it should run the full suite — which is the check that the filter is not too eager.

🤖 Generated with Claude Code

A docs commit was taking the same ~10 minutes as a code change: full sync,
ruff, mypy and the whole pytest suite, to check prose.

`lint` and `test` are required status checks on `main`, so they cannot be
skipped outright — a required check that never reports blocks the pull request
permanently, which is worse than running it. So both jobs still run and still
report; a `changes` job decides whether they do the expensive part.

The filter is deliberately biased towards running: a path it does not
recognise counts as code. A new top-level file nobody thought about gets the
gates rather than a pass, and a push to main or a manual run always runs
everything.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@thedancingdeveloper
thedancingdeveloper merged commit 8eb68ec into main Aug 6, 2026
3 checks passed
@thedancingdeveloper
thedancingdeveloper deleted the ci/skip-the-suite-for-docs branch August 6, 2026 02:47
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.

1 participant