📖🔧：spell-check everything, in American English - #1852
Merged
Conversation
The spell checker read Markdown and nothing else, so comments and templates were unread and drifted into British spelling. It now reads every file that carries prose, and cspell's `en` dictionary is the American one, which is what holds the project to one spelling: a British variant is a word it does not know. Twenty-eight of them are corrected, and the editor setting that let `behaviour` through is gone. Four the dictionary accepts either way, `centre` among them, were found by hand. Scanning code found a typo in the bargain: `metdata`. Fifty-six terms are added for vocabulary the wider scan meets, and forty-eight removed that cspell already knew and never needed. What is left is the words this project uses that no dictionary carries. Signed-off-by: Derek Lewis <DerekNonGeneric@inf.is> Assisted-by: Claude-Code:claude-opus-5
✅ Deploy Preview for gh-pages-openinf ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
OpenINFbot
approved these changes
Aug 24, 2026
openinf-commit-queue
Bot
removed
the
commit-queue
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
2 participants
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.
cspell read Markdown and nothing else, so comments, templates and stylesheets
were never checked and drifted into British spelling. It now reads every file
that carries prose.
That is also the enforcement: cspell's
endictionary is the American one, soa British variant is simply a word it does not know. No extra rule, no word
list to maintain.
What was wrong
Twenty-eight British spellings across thirteen files, in comments, in a test
name, and in two pieces of user-facing prose:
/about/'s meta description andthe home page's "across the organisation".
.vscode/settings.jsoncarried"cSpell.ignoreWords": ["behaviour"], whichexisted to let one of them past. Removed with the word it protected.
Four more the dictionary accepts either way —
centre,centred,colouredand one other — do not trip cspell and were found by hand. They are the reason
this cannot be left entirely to the tool.
Scanning code found a typo in the bargain:
metdatainsiteify-health-files.mts, three years of nobody reading that line.The dictionary
Fifty-six terms added for the vocabulary a wider scan meets: Liquid keywords,
schema.org attributes,
relvalues, shell builtins, extension identifiers.Forty-eight removed.
OpenINF,SDK,macOS,PowerShell,changelogandthe rest were never needed — cspell's own dictionaries already know them, and
they were being whitelisted against nothing. 131 entries become 85, and what
is left is the words this project uses that no dictionary carries.
Shape
cspell moves out of
verify-md.mtsintoverify-spelling.mts, so Markdown isnot read twice and the eighteenth verifier is about one thing. The exclusions
live in
cspell.jsonas well as the task, so the editor extension and thebuild agree on what is not ours to spell: vendored licenses, the lockfile, and
the health files generated from
OpenINF/.github.Checks
nps testpasses, all 18. Verified the gate bites: a.scsscomment readingcolouris now a build failure, where before it was unread. Repo sweptafterwards for the whole class — no British spelling remains outside the
verbatim license texts.
Note
Some British forms are invisible to any dictionary.
speltforspelledisin the repository and is a real word either way;
analysisis correctAmerican and looks British to a naive search. A checker gets most of this and
not all of it.