Fix broken anchors and links found by check-links --check-anchors

[marcleblanc2]

Linear FE-499: Fix doc site issues

Original all-in-one PR, being split into per-bucket PRs under FE-499 for easier review: #1864 (mechanical slug drift), #1865 (dead sections), #1866 (moved pages), #1867 (markup), #1868–#1872 (reworded headings, by docs area). Kept for reference until the batch lands; not meant to merge. Fixes every broken internal link and #anchor reported by npm run check-links -- --check-anchors (the checker from #1858, with its fence-stripping and duplicate-route fixes). 123 files, links only, no prose rewrites beyond a few unlinked phrases.

What changed (buckets of broken links)

• Renamed / mistyped anchors
  • Corrected to the slug the heading actually produces (#index-jobs → #index_jobs, #kubernetes → #kubernetes-helm, #nginx-ssl-https-configuration → #nginx-sslhttps-configuration, alert/dashboard slugs with underscores, #Literal-search-default → #keyword-search-default, etc.)
• Moved content relinked
  • /admin/faq#… → /self-hosted/faq#…, docker-compose anchors → /self-hosted/deploy/docker-compose/{configuration,operations}, kustomize file anchors → /self-hosted/deploy/kubernetes/kustomize#step-3-set-up-the-configuration-files, #template / #base → the deploy-sourcegraph-k8s directories on GitHub
• Dead sections
  • Anchor dropped, page link kept
• href="#" QuickLink placeholders
  • On the Kubernetes pages now point at the page they describe
• Corrupted markup
  • [search.largeF[iles](...) and The o)rder in technical-changelog.mdx; `"true``` / `"*``` inline code in batch-spec-yaml-reference.mdx (these stray backticks also broke the checker's fence tracking); stray " in an anchor in kubernetes/troubleshoot.mdx.

Follow-ups (not in this PR)

1 - Links into the site-config / code-host JSON schema (/admin/config/site-config#search.largeFiles, /admin/code-hosts/github#rateLimit, …) are left as-is: the schema renders as a code block with no per-key anchors, so the fix belongs in the site, not the docs. The checker still reports these 24 anchors.

2 - Three routes have two source files, and the site serves the first one glob order returns; the other is unreachable:

• cli/references/auth: auth.mdx (served) vs auth/index.mdx (richer, links subcommands)
• cli/references/codeowners: same pattern
• self-hosted/deploy/kubernetes/kustomize: kustomize.mdx (served) vs kustomize/index.mdx (concept doc, shadowed since 2024)

Each pair should be merged or one deleted. Reported in Slack thread.

Verify

npm run check-links -- --check-anchors

Amp threads

• Docs - Fix broken heading links

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
sourcegraph-docs	Ready	Preview	Sep 7, 2026 10:24pm UTC

[marcleblanc2]

This link is intended to go do the site config schema section for saml, but that's broken because the site config schema is a JSON blob, and markdown headers aren't supported inside a giant JSON blob.

Linking instead to the saml docs page is not the intended path, but I'm not sure what else to do here.