Skip to content

fix(docs): correct spelling and duplicated words across docs - #2149

Merged
travisbeckham merged 3 commits into
linkerd:mainfrom
joedrf:fix-docs-typos
Jul 30, 2026
Merged

travisbeckham merged 3 commits into
linkerd:mainfrom
joedrf:fix-docs-typos

Conversation

@joedrf

@joedrf joedrf commented Jul 26, 2026

Copy link
Copy Markdown
Contributor

What

Corrects 29 spelling errors and duplicated words in the docs. 31 unique lines changed;
the file count is large only because each correction is applied to every versioned copy
of the affected page.

reference/

Fix Page
Conncections → Connections (heading) reference/architecture.md
unavailble → unavailable (×2) reference/circuit-breaking.md
minumum → minimum reference/circuit-breaking.md
crytpographic → cryptographic reference/proxy-metrics.md
to which which the → to which the reference/proxy-metrics.md
decribes → describes reference/authorization-policy.md
precendence → precedence reference/authorization-policy.md
which authenticate thes → which authenticates the reference/authorization-policy.md

tasks/

Fix Page
accross → across, resiliant → resilient tasks/federated-services.md
dyanmic → dynamic tasks/configuring-dynamic-request-routing.md
proxy-injnector → proxy-injector, dupliate → duplicate tasks/troubleshooting.md
tutoral → tutorial, consective → consecutive tasks/circuit-breakers.md
Instrunctions → Instructions tasks/install.md, tasks/install-helm.md
recieve → receive, of the the → of the tasks/traffic-shifting.md
instaneously → instantaneously tasks/automatically-rotating-control-plane-tls-credentials.md
Uninstallating → Uninstalling tasks/uninstall.md
such as as the one → such as the one tasks/grafana.md
they wil be → they will be tasks/rotating_webhooks_certificates.md
used to to provide → used to provide tasks/setting-up-service-profiles.md
how to to use → how to use tasks/generate-certificates.md
meshed with with → meshed with, stray , , → , tasks/using-ingress.md

features/

Fix Page
Kuberentes → Kubernetes features/automatic-mtls.md
Futher reading → Further reading (heading) features/dashboard.md
is to to provide → is to provide features/topology-aware-routing.md

Scope

Each fix is applied to every versioned directory in which the string actually appears
(2-edge, docs, and 2.10–2.19), following the convention in #1961 and #2137.
Reviewing linkerd.io/content/2-edge alone shows all 31 unique changes without the
per-version repetition.

Commits are split by docs area (reference, tasks, features) so they can be taken
independently if preferred.

How these were found

Extracted the visible prose from every page in the sitemap (excluding code blocks and
navigation), ran it through hunspell, then filtered to words that are rare on the site
but one edit away from a word the site uses frequently. Every candidate was re-checked
against the rendered page before being included here, and a few apparent hits were
discarded as false positives (for example as as inside "has as", and a diacovery
that turns out to be inside a verbatim quoted tweet in a blog post).

Notes

  • make lint passes; no new markdownlint warnings.
  • No content changes beyond spelling and duplicated words. Blog posts are untouched here
    and will follow separately.
  • One further typo, Appache Common Log Format, lives in linkerd.io/data/cli/*.yaml,
    which is auto-generated by linkerd doc. It needs fixing in linkerd/linkerd2 instead,
    otherwise it returns on the next regeneration, so it is deliberately not included.

joedrf added 3 commits July 26, 2026 17:24
- Conncections -> Connections
- unavailble -> unavailable
- minumum -> minimum
- crytpographic -> cryptographic
- duplicated 'which which'
- decribes -> describes
- precendence -> precedence
- 'authenticate thes' -> 'authenticates the'

Applied across all versioned docs directories (2-edge, docs, 2.10-2.19),
following the convention in linkerd#1961 and linkerd#2137.

Signed-off-by: joedrf <joe@buoyant.io>
- accross -> across
- resiliant -> resilient
- dyanmic -> dynamic
- proxy-injnector -> proxy-injector
- dupliate -> duplicate
- tutoral -> tutorial
- consective -> consecutive
- Instrunctions -> Instructions
- recieve -> receive
- duplicated 'the the'
- instaneously -> instantaneously
- Uninstallating -> Uninstalling
- duplicated 'as as'
- wil -> will
- duplicated 'to to'
- duplicated 'to to'
- duplicated 'with with'
- stray double comma

Applied across all versioned docs directories (2-edge, docs, 2.10-2.19),
following the convention in linkerd#1961 and linkerd#2137.

Signed-off-by: joedrf <joe@buoyant.io>
- Kuberentes -> Kubernetes
- Futher -> Further
- duplicated 'to to'

Applied across all versioned docs directories (2-edge, docs, 2.10-2.19),
following the convention in linkerd#1961 and linkerd#2137.

Signed-off-by: joedrf <joe@buoyant.io>
@joedrf
joedrf marked this pull request as ready for review July 27, 2026 08:17
@travisbeckham
travisbeckham self-requested a review July 27, 2026 14:05

@travisbeckham travisbeckham left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! Thanks for fixing all of these.

@travisbeckham
travisbeckham merged commit 3113437 into linkerd:main Jul 30, 2026
7 checks passed
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.

2 participants