Skip to content

docs(releases): drop reserved word "role" from v15 kanban note - #3081

Merged
os-zhuang merged 1 commit into
mainfrom
fix/role-word-v15-doc
Jul 17, 2026
Merged

docs(releases): drop reserved word "role" from v15 kanban note#3081
os-zhuang merged 1 commit into
mainfrom
fix/role-word-v15-doc

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Problem

The check:role-word ratchet (ADR-0090 D3) is failing on mainrun 29542732386:

content/docs/releases/v15.mdx: NEW use of the reserved word "role" (1 occurrence(s)).

Root cause

#3079 ("curate the 15.1 line") added a generic-English "lanes honor the ADR-0085 stageField role" to content/docs/releases/v15.mdx. That file isn't in scripts/role-word-baseline.json, so the ratchet flags it as a new occurrence and fails the ESLint job on every subsequent push.

Fix

Reword to "the stageFieldsetting". The sentence is about which field drives kanban lanes — not the authz concept — so this is a plain reword, not a genuine boundary; no baseline entry needed.

Verified locally: node scripts/check-role-word.mjsOK (49 baselined file(s), no new occurrences).

🤖 Generated with Claude Code

ADR-0090 D3 makes "role" a reserved-forbidden word in hand-written docs,
enforced by the check:role-word ratchet. #3079 introduced a generic-English
"the `stageField` role" in content/docs/releases/v15.mdx that is not in the
baseline, breaking the ratchet on main. Reword to "the `stageField` setting"
— the sentence is about which field drives lanes, not authz — so no baseline
entry is needed.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specBuildingBuildingPreview, CommentJul 17, 2026 12:13am

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation size/xs labels Jul 17, 2026
@os-zhuang
os-zhuang merged commit 0008415 into mainJul 17, 2026
12 of 14 checks passed
@os-zhuang
os-zhuang deleted the fix/role-word-v15-doc branch July 17, 2026 00:14
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang