Skip to content

docs(redirects): add 33 verified redirects for pre-migration URLs still 404ing - #2299

Open
GigaHierz wants to merge 2 commits into
mainfrom
GigaHierz/redirect-audit-missing
Open

docs(redirects): add 33 verified redirects for pre-migration URLs still 404ing#2299
GigaHierz wants to merge 2 commits into
mainfrom
GigaHierz/redirect-audit-missing

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

Why

GA4 shows the "Page Not Found" page is the #4 most-viewed page on docs.celo.org (~4.4% of pageviews). An audit of the full git history (git log --all, both the Docusaurus and Mintlify eras) found ~1,266 old public URLs that 404 with no redirect. See #2298 for the full breakdown.

What this PR does

Adds the 33 high-confidence redirects from that audit — the subset where the destination was verified to be a live page on main. Highlights:

  • /about-celo/:slug* → /home/:slug* — one wildcard that covers 26 pages from the about-celo/home/ rename.
  • /developer/dev-environments/{hardhat,foundry,remix,thirdweb}/tooling/dev-environments/* (not caught by existing /developer/* wildcards).
  • Old oracle/, holder/manage/, community/, general/, testnet disclaimer paths → their current homes.

+132 lines, docs.json only.

What it does NOT do (tracked in #2298)

  • The 3 bulk buckets (old /blog/** 415, /v2/** 107, generated /developer-resources/** API dumps 449) — those need a target decision.
  • ~215 individual paths with no confident target — need editorial triage.

Verification

  • Every destination confirmed to resolve to a live .mdx page on main (0 dead).
  • 0 source collisions with the existing 714 redirects; no duplicate sources.
  • docs.json re-validates as JSON (714 → 747 redirects).
  • Live spot-check confirmed the old sources currently 404 (e.g. /about-celo/gas-fees, /protocol/identity/odis).

Refs #2298

🤖 Generated with Claude Code

…ll 404ing

GA4 shows 'Page Not Found' is the #4 most-viewed page (~4.4% of pageviews).
An audit of the full git history found ~1,266 old public URLs that 404 with
no redirect. This adds the 33 high-confidence ones — every destination
verified to be a live page on main — led by /about-celo/:slug* -> /home/:slug*
(covers 26 pages). Bulk buckets (old blog, v2 GitBook, generated API dumps)
and paths needing editorial targets are tracked in the issue, not here.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… developer-resources trees

Per audit triage: /blog/* and /v2/* -> / (content retired); /developer-resources/* -> /build-on-celo (getting-started hub). These sit after the specific redirects so the specific ones win. Closes the three bulk 404 buckets (415 + 107 + 449 URLs). Refs #2298

Co-Authored-By: Claude Opus 4.8 <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