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 stageField setting". 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

vercel Bot commented Jul 17, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Building Building Preview, Comment Jul 17, 2026 12:13am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/xs labels Jul 17, 2026
@os-zhuang
os-zhuang merged commit 0008415 into main Jul 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 free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant