From b7dd2353b323dee36ba15535ff4bb1754c71b347 Mon Sep 17 00:00:00 2001 From: Marc LeBlanc <7050295+marcleblanc2@users.noreply.github.com> Date: Thu, 17 Sep 2026 04:48:17 -0600 Subject: [PATCH 1/2] dev/TODO: Record the docs site audit findings that have no PR yet Co-authored-by: Amp Amp-Thread-ID: https://ampcode.com/threads/T-01a0aed2-5fbe-7768-85ea-1378bf98f9ff --- dev/TODO.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/dev/TODO.md b/dev/TODO.md index 03245b340..9ba5519a5 100644 --- a/dev/TODO.md +++ b/dev/TODO.md @@ -4,3 +4,32 @@ React Compiler ESLint rules `react-hooks/refs`, `react-hooks/set-state-in-effect` and `react-hooks/static-components` can go back to `error` in `eslint.config.mjs` (31 of the 39 warnings from `pnpm run lint` are in that directory) + +## Docs site audit leftovers + +Findings from the crawl of all 502 pages +() +with no PR yet. Fixes with PRs: #1998–#2004. + +- Cloudflare AI Labyrinth injects a hidden `` + as the first child of `` for suspected bots, so React hydration fails + (#418) on 102 of 502 pages. Cloudflare setting: exclude + `sourcegraph.com/docs/*` from AI Labyrinth. +- Every page has the same `` + (`src/app/layout.tsx`); `generateMetadata` in `src/app/[...slug]/page.tsx` + never sets one. Derive it from the first paragraph. +- Duplicate ``s: the title is the first heading only, so 4 pages are + "How-to guides", 3 "FAQs", 3 "How-tos", … Suffix with the parent section. +- `src/app/sitemap.ts`: `lastmod` is the build time for every page, and both + `/docs` and `/docs/` are listed. +- `docs/self-hosted/postgresql-collation-version-mismatch-resolution.mdx` + renders 10 `<h1>`s; demote all but the first. +- `docs/integration/gitlab.mdx:29` embeds `img/gitlab-code-intel.gif`, but + nothing serves `docs/**/img` (404); move it to `public/` after #1977 lands. + The other ~50 files in `docs/integration/img/` are orphaned. +- Code-comment colour in the syntax theme is `#B362FF` on `#2d2b55` (3.84:1, + below WCAG AA); the rest of the contrast findings landed in #1995. +- `/admin/config/site-config#<key>` anchors (19 inbound links) do not exist: + the schema renderer emits no per-key ids. Deferred by #1925. +- `/self-hosted/observability/dashboards` is generated from the + sourcegraph/sourcegraph sync (#1971) and is a giant page; fix upstream. From 70aba053f596e5de1a4db33bcbb7993aa7e4efb1 Mon Sep 17 00:00:00 2001 From: Marc LeBlanc <7050295+marcleblanc2@users.noreply.github.com> Date: Thu, 17 Sep 2026 04:50:01 -0600 Subject: [PATCH 2/2] dev/TODO: Fix spelling flagged by CSpell Co-authored-by: Amp <amp@ampcode.com> Amp-Thread-ID: https://ampcode.com/threads/T-01a0aed2-5fbe-7768-85ea-1378bf98f9ff --- dev/TODO.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/dev/TODO.md b/dev/TODO.md index 9ba5519a5..eb7f70f79 100644 --- a/dev/TODO.md +++ b/dev/TODO.md @@ -20,14 +20,14 @@ with no PR yet. Fixes with PRs: #1998–#2004. never sets one. Derive it from the first paragraph. - Duplicate `<title>`s: the title is the first heading only, so 4 pages are "How-to guides", 3 "FAQs", 3 "How-tos", … Suffix with the parent section. -- `src/app/sitemap.ts`: `lastmod` is the build time for every page, and both - `/docs` and `/docs/` are listed. +- `src/app/sitemap.ts`: the last-modified time is the build time for every + page, and both `/docs` and `/docs/` are listed. - `docs/self-hosted/postgresql-collation-version-mismatch-resolution.mdx` renders 10 `<h1>`s; demote all but the first. - `docs/integration/gitlab.mdx:29` embeds `img/gitlab-code-intel.gif`, but nothing serves `docs/**/img` (404); move it to `public/` after #1977 lands. The other ~50 files in `docs/integration/img/` are orphaned. -- Code-comment colour in the syntax theme is `#B362FF` on `#2d2b55` (3.84:1, +- Code-comment color in the syntax theme is `#B362FF` on `#2d2b55` (3.84:1, below WCAG AA); the rest of the contrast findings landed in #1995. - `/admin/config/site-config#<key>` anchors (19 inbound links) do not exist: the schema renderer emits no per-key ids. Deferred by #1925.