Skip to content

chore: fix typos repo-wide and close the CI spell check gap#833

Open
ananos wants to merge 3 commits into
mainfrom
chore/typo-sweep
Open

chore: fix typos repo-wide and close the CI spell check gap#833
ananos wants to merge 3 commits into
mainfrom
chore/typo-sweep

Conversation

@ananos

@ananos ananos commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Description

This PR sweeps the repository for typos and grammar errors and fixes the reason CI was not catching them.

Typo and grammar fixes (docs: and style: commits):

  • Documentation, README and CHANGELOG: misspellings (e.g. rirecracker -> firecracker, lastest -> latest, Fotran -> Fortran, Cloud-HYpervisor -> Cloud-Hypervisor, "in the same directly" -> "directory") and a number of grammar slips (subject-verb agreement, "a initrd" -> "an initrd", "Except of" -> "Apart from", missing sentence breaks).
  • Two semantic corrections in the docs, please double-check these:
    • docs/unikernel-support.md: the MirageOS and Rumprun monitor lists linked Solo5 twice; they now name Solo5-hvt and Solo5-spt explicitly.
    • docs/installation.md: "any earlier version of Go 1.20.6 should be sufficient" inverted the intended meaning; it now reads "any version of Go 1.20.6 or later". Also monitor-builds -> monitors-build (the actual repository name).
  • Go sources: typo fixes in comments and two error message strings ("this a queue proxy container", "Operation not support"). No functional change: both error values are only compared as sentinels, never by text.
  • Makefile: fix the "Dcos targets" comment.

Why CI missed these (ci: commit):

  1. Ignore-regex bug: the inline-code pattern `[^`]+` in .github/linters/.cspell.json matched across newlines, pairing the closing backtick of one code span with the opening backtick of the next one. In backtick-heavy pages this hid most of the prose from cspell entirely. The pattern is now restricted to a single line and a duplicate entry was dropped. This alone surfaced 25 previously hidden words.
  2. Typos whitelisted in the dictionary: several entries in urunc-dict.txt were real misspellings added to silence the checker (burdain, levarage, secomp, triger, isues, vlaid, ...). These are removed and their occurrences fixed. Entries that look like typos but are required by cspell's tokenizer were kept (e.g. urunce/etesting from package urunce2etesting, Prettyfier from logrus's CallerPrettyfier field, scontroller/sworker from the k0scontroller/k0sworker service names).
  3. Residual limits: misspell in golangci-lint runs with only-new-issues: true, so pre-existing typos in Go code are never reported, and grammar-level errors ("the followings", "instructions fo using": fo and followings are valid en_US dictionary words) are invisible to any spell checker. Those categories were fixed manually here and will need human review to catch in the future.

Related issues

How was this tested?

All testing on Linux amd64 (Ubuntu 24.04, containerd 2.3.3, devmapper), plus spell/commit lint locally:

  • cspell --config .github/linters/.cspell.json: 0 issues on 158 files with the stricter regex.
  • commitlint --from=origin/main with the repo config: all three commits pass.
  • go build ./... && go vet ./... && gofmt -l: clean; the Go diff touches only comments and the two string literals.
  • make lint (golangci-lint v2.9 container): reports 4 findings (1 ineffassign, 3 unused) that are byte-identical on pristine origin/main; this branch introduces no new findings (the CI gate runs with only-new-issues: true).
  • Unit tests (make unittest): pass. (When run as root, TestCopyFile/TestMoveFile fail because root bypasses the permission denials they assert; this reproduces identically on pristine main and is unrelated.)
  • e2e (make test_ctr) with urunc + shim built from this branch (make + make install): all 11 specs for the working monitors on the test host (qemu, firecracker) pass. The 6 Solo5 (Hvt-*/Spt-*) specs fail with the exact same reexec RX_ERROR when running urunc built from pristine origin/main on the same host (nested-KVM environment issue, pre-existing and unrelated to this PR).

LLM usage

Claude Fable 5 (via Claude Code) assisted with this PR and the associated issue, per the LLM policy. All changes were reviewed and tested by the contributor, who takes full responsibility for them.

Checklist

  • I have read the contribution guide.
  • The linter passes locally (make lint).
  • The e2e tests of at least one tool pass locally (make test_ctr, make test_nerdctl, make test_docker, make test_crictl).
  • If LLMs were used: I have read the llm policy.

ananos added 3 commits July 17, 2026 12:59
Fix misspellings and grammar slips across the docs, README and
CHANGELOG. Apart from wording, there are three corrections that
change meaning:

- name Solo5-hvt and Solo5-spt explicitly in the MirageOS and
  Rumprun monitor lists instead of two identical Solo5 links
- fix the inverted Go version requirement wording in the
  installation guide (1.20.6 or later, not earlier)
- fix the monitors-build repository name in the installation guide

Signed-off-by: Anastassios Nanos <ananos@nubificus.co.uk>
Fix misspellings in Go comments, in two error message strings and in
a Makefile comment. No functional change: the error values are only
compared as sentinels, never by text. go build and go vet pass.

Signed-off-by: Anastassios Nanos <ananos@nubificus.co.uk>
The cspell ignore pattern for inline code also matched across
newlines, pairing the closing backtick of one code span with the
opening backtick of the next one. In backtick-heavy documents this
hid most of the prose from the spell checker. Restrict the pattern
to a single line and drop a duplicate entry of it.

Also clean up the project dictionary: drop entries that were added
for words that are actually misspellings (now fixed in the tree)
and add the legitimate terms that the wider net now surfaces.

Fixes: #832
Signed-off-by: Anastassios Nanos <ananos@nubificus.co.uk>
@netlify

netlify Bot commented Jul 17, 2026

Copy link
Copy Markdown

Deploy Preview for urunc ready!

Name Link
🔨 Latest commit c9bd663
🔍 Latest deploy log https://app.netlify.com/projects/urunc/deploys/6a59fd57ecd9420008c75481
😎 Deploy Preview https://deploy-preview-833--urunc.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@ananos
ananos marked this pull request as ready for review July 17, 2026 10:03
@ananos
ananos requested a review from cmainas July 17, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Spell check CI misses typos in docs and code

1 participant