Skip to content

Add codespell config, CI workflow, and fix existing typos - #26

Open
yarikoptic wants to merge 5 commits into
aplbrain:mainfrom
yarikoptic:enh-codespell
Open

Add codespell config, CI workflow, and fix existing typos#26
yarikoptic wants to merge 5 commits into
aplbrain:mainfrom
yarikoptic:enh-codespell

Conversation

@yarikoptic

Copy link
Copy Markdown

Add codespell configuration, a GitHub Actions workflow that runs it on PRs / pushes to main, and fix the typos it (and I) found in the docs.

I've introduced codespell to many open-source projects with positive feedback (see improveit-dashboard/READMEs/yarikoptic.md for context). The CI workflow uses permissions: contents: read only.

Changes at a glance

  • Config (pyproject.toml [tool.codespell]): skip .git-meta, binaries and lock files; whitelist shure (microphone brand, "Shure SM7B").
  • CI (.github/workflows/codespell.yml): runs on push / PRs to main, read-only permissions.
  • Typo fixes in 5 doc files (7 typos total).

Testing

  • codespell passes with zero errors on the branch (verified locally with uvx codespell and via the new workflow).
Typo fixes (7)

Non-ambiguous, fixed via codespell -w (recorded reproducibly with datalad run):

File Before After
README.md:29 Contibutions Contributions
docs/example-standardization-and-reproducibility/Suthana_Zenodo.md:36 (heading) Verfication Verification
docs/getting-started/index.md:18 acounts accounts
docs/user-guide/embervault-uploading-data.md:17 instituion institution

Ambiguous (single suggestion tie: this / these), decided from context:

File Before After
docs/user-guide/dandi-cli.md:3 "In thes instructions, you…" "In these instructions, you…"

Spotted while reviewing surrounding context (not in codespell's default dictionaries):

File Before After
docs/getting-started/index.md:17 accounr account
docs/getting-started/index.md:20 approal approval
Config choices
  • .git-meta in skip: a per-repo working folder for commit / PR message drafts (git-excluded, never committed). Codespell walks the filesystem, so it would otherwise re-flag the very typos being fixed inside quoted commit messages.
  • shure in ignore-words-list: appears in docs/user-guide/data-standardization.md as "Microphone": "Shure SM7B" — Shure is a legitimate microphone brand, not a typo of "sure".
  • Extended-dictionary pass (--builtin clear,rare,usage,code,names) surfaces only Jupyter → Jupiter, a false positive (Jupyter notebook is intentional). No further whitelist entries needed because the default CI pass is clean.

🤖 Generated with Claude Code and love to typos-free code

yarikoptic and others added 5 commits August 27, 2026 12:17
Config changes:
- Add .git-meta to skip list (per-repo working folder for commit/PR
  drafts; commonly quotes the very typos being fixed).
- Whitelist "shure" (Shure is a microphone brand, e.g. "Shure SM7B").

Ambiguous typo fix (single suggestion tie: this/these):
- docs/user-guide/dandi-cli.md:3 "In thes instructions" -> "these"
  (refers to the multi-step instructions that follow).

Co-Authored-By: Claude Code 2.1.247 / Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Fixed typos:
- Contibutions -> Contributions (README.md)
- Verfication -> Verification (docs/example-standardization-and-reproducibility/Suthana_Zenodo.md)
- acounts -> accounts (docs/getting-started/index.md)
- instituion -> institution (docs/user-guide/embervault-uploading-data.md)

Co-Authored-By: Claude Code 2.1.247 / Claude Opus 4.7 (1M context) <noreply@anthropic.com>

=== Do not change lines below ===
{
 "chain": [],
 "cmd": "uvx codespell -w",
 "exit": 0,
 "extra_inputs": [],
 "inputs": [],
 "outputs": [],
 "pwd": "."
}
^^^ Do not change lines above ^^^
Spotted while reviewing surrounding context of codespell fixes;
codespell's default dictionaries do not carry either mapping:

- docs/getting-started/index.md:17 "accounr" -> "account"
- docs/getting-started/index.md:20 "approal" -> "approval"

Co-Authored-By: Claude Code 2.1.247 / Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant