Skip to content

Introduce codespell + fix configration.md filename typo (with redirect) - #8

Open
yarikoptic wants to merge 4 commits into
donetick:mainfrom
yarikoptic:enh-codespell
Open

Introduce codespell + fix configration.md filename typo (with redirect)#8
yarikoptic wants to merge 4 commits into
donetick:mainfrom
yarikoptic:enh-codespell

Conversation

@yarikoptic

Copy link
Copy Markdown

Summary

Introduce codespell for spell-checking, fix the typos it caught, and — as a follow-up made necessary by one of those fixes — rename the misspelled configration.md file and wire up a redirect so old URLs keep working.

Initially got here by observing it in authelia docs to refer to a url with a typo.

Why the file rename is bundled here: codespell corrected the link text configrationconfiguration in getting-started.md, pushover.md and telegram.md, but only text; the file itself remained configration.md. With onBrokenLinks: 'throw' those links then pointed at a non-existent page and the site would fail to build. Renaming the file and adding a client-side redirect makes the build green again and keeps external bookmarks / search-engine entries to the old URL working (including anchor fragments like #pushover and #telegram).

yarikoptic and others added 4 commits August 28, 2026 22:07
…s automagically

=== Do not change lines below ===
{
 "chain": [],
 "cmd": "codespell -w",
 "exit": 0,
 "extra_inputs": [],
 "inputs": [],
 "outputs": [],
 "pwd": "."
}
^^^ Do not change lines above ^^^
The prior codespell run (132e2e0) corrected `configration` -> `configuration`
in link text within getting-started.md, pushover.md and telegram.md, but
did not rename the actual file. With `onBrokenLinks: 'throw'` those links
pointed at a non-existent page and the site failed to build.

- git mv the file to the correctly-spelled name so internal links resolve.
- Add @docusaurus/plugin-client-redirects and register a redirect from
  /getting-started/configration -> /getting-started/configuration so any
  external bookmarks / search-engine links to the old path keep working.
  Hash fragments (e.g. #pushover, #telegram used from the notifications
  pages) are preserved by the plugin's client-side redirect.

Verified with `npm run build` (no broken links) and Playwright:
- /getting-started/configration              -> new URL, page renders
- /getting-started/configration#pushover     -> new URL + #pushover
- Link click from /getting-started/          -> new URL
- Article links on pushover.md / telegram.md -> new URL with anchor

Co-Authored-By: Claude Code 2.1.251 / Claude Opus 4.7 <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