Commit aef640e
committed
fix: silence the spell checker on a generated anchor that strips an apostrophe
CI's hygiene job went red on typos, and the finding is real rather than a
false positive worth arguing with: the table-of-contents row this branch
generated for design-level.md carries the anchor
#domain-events-in-depth-why-theyre-special, and "theyre" is a word the checker
corrects to "their" or "there".
The anchor cannot be spelled any other way. GitHub's slugger strips apostrophes,
so a heading containing a contraction produces exactly that token, and changing
it breaks the link. The heading itself, "Domain Events in Depth (Why They're
Special)", is pre-existing and out of this branch's scope to reword.
So the generated block carries the repo's markdown spellchecker directive, and
the suppression costs no coverage: every row in a table of contents echoes a
heading that is still spell-checked where it is actually written, further down
the file. A genuine typo in that heading would still be caught there.
Scoped to the one block rather than added to _typos.toml, which is the
constellation-wide synced policy and says plainly that a repo-specific exception
does not belong in it.
Verified: typos exits 0 over the tree, markdownlint clean on the file, and all
124 tables of contents still resolve with zero dangling anchors.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FTVH5ZRVph75kvxzUAnb6q1 parent 969f4bd commit aef640e
1 file changed
Lines changed: 8 additions & 0 deletions
Lines changed: 8 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
5 | 12 | | |
6 | 13 | | |
7 | 14 | | |
| |||
11 | 18 | | |
12 | 19 | | |
13 | 20 | | |
| 21 | + | |
14 | 22 | | |
15 | 23 | | |
16 | 24 | | |
| |||
0 commit comments