[mache-4515db] ci: gate docs on doc changes (docs:lint was hidden by paths-ignore)#529
Merged
Merged
Conversation
…ci.yml paths-ignore) ci.yml paths-ignores **.md + docs/** so the heavy Go/integration matrix skips doc-only changes — correct. But task docs:lint lived INSIDE that ignored job, so the one check meant to gate docs (covers-version vs CHANGELOG, last-verified staleness, mache language-count claims vs internal/lang/lang.go) never ran on doc-only PRs. New docs.yml has the inverse trigger (runs ONLY on **.md + docs/** + CHANGELOG.md), so between the two workflows every change is covered exactly once. Grep-based docs-lint.sh needs no Go build, so it's fast.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes a gap found while reviewing CI triggers:
ci.ymlpaths-ignores**.md+docs/**(correct — the heavy Go/integration matrix shouldn't run on doc-only changes), buttask docs:lintlives inside that ignored job. So a doc-only PR — the exact casedocs:lintexists for — skips the one check meant to gate documentation.docs:lintvalidates:covers-versionvs the latest CHANGELOG heading,last-verifiedstaleness, and mache language-count claims vsinternal/lang/lang.go. All three can silently drift in a doc-only PR today.Fix
New
docs.ymlwith the inverse trigger — runs only on**.md+docs/**+CHANGELOG.md. Between the two workflows every change is covered exactly once (no overlap, no gap).docs-lint.shis grep-based (no Go build), so the job is fast; it installstaskviago installmatchingci.yml's convention (bypasses the arduino/setup-task CDN 502s).Verification
task docs:lint0 fail 0 warn;task lint:actions(SHA-pin gate) +task lint:yamlpass.Note
This is independent of the CGO/leyline arc (#527/#528) — pure CI hygiene, off main.
🤖 Generated with Claude Code