fix: repair dead-URL redirects and add 301s for removed doc versions - #2072
Merged
Conversation
Sourced from the Matomo 404 inventory (2026-06-14..07-11, 11,401 Page-Not-Found visits) with every URL re-verified against the live site: - Retarget the version-less ingress-controller rules that still pointed at 1.8.0 — those pages are no longer built, so the rules themselves were generating 404s (incl. hijacking the real /FAQ/ and /upgrade/ pages that exist again in the 2.x IA). - Strip the version segment from removed sub-project doc versions (ingress-controller 0.x/1.x, docker apisix-*/apisix-dashboard-*, apisix 2.1-2.5); renamed pages chain onto the retargeting rules. - Redirect removed dashboard docs to /docs/apisix/dashboard/. - Send bare landing directories that 403 (no index) to real entry pages. - Fix /docs/apisix/stand-alone and a GitHub-style path. Verified with a local httpd (mod_alias + this .htaccess): 89 of 92 currently-broken URLs now terminate at a live 200 page within 2 hops, zero redirect loops, and a 38-URL control set of live pages passes through untouched.
/docs/apisix/how-to-build/ and /docs/apisix/architecture-design/plugin-config/ are themselves 404 in the current IA; the new version-stripping rules were routing fresh traffic into them. Point install -> building-apisix/ and the plugin rules -> terminology/plugin-config/ (en+zh), let bare removed ingress version dirs chain to overview via (.*), and fix a comment that implied mod_alias rule order matters across hops. Re-verified with local httpd: audit-flagged chains now 200 in <=2 hops; full 92-URL suite and 32-URL control set unchanged (0 loops, 0 hijacks).
Member
Author
|
Independent audit verdict: MERGE (0 HIGH). The one MEDIUM — the new strip rules funneled traffic into four pre-existing redirects whose targets ( |
Yilialinn
approved these changes
Jul 13, 2026
LiteSun
approved these changes
Jul 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
Matomo (Apache Analytics, site 17) recorded 11,401 Page-Not-Found visits in 2026-06-14..07-11 (+485% vs the prior period). Probing every URL in the top-120 404 inventory against the live site shows 92 are still broken today, in four classes:
.htaccessstill redirect to1.8.0/...— but 1.8.0 is no longer built (only the newest release is published since chore(website): clean up doc/blog workspaces + open homepage links in new tab #2066-era pruning), so our own redirects generate 404s. They even hijack/docs/ingress-controller/FAQ/and/upgrade/, which exist again as real pages in the current IA.apisix-*/apisix-dashboard-*, apisix 2.1–2.5 — still linked from search results and external sites./docs/apisix/,/docs/apisix/plugins/,/docs/ingress-controller/, …) return 403 (no index page) while receiving real traffic./docs/apisix/stand-alone; GitHub-style paths.Fix
/docs/apisix/dashboard/, bare landing dirs to real entry pages, plus two renamed-path fixes.Verification (local httpd, mod_alias + this exact .htaccess)
/docs/ingress-controller/1.8.0/FAQ/chains to/FAQ/, which becomes a real page once this deploys (the hijack rule is removed in the same change)./v2(95 hits, ambiguous intent — no defensible target) and one single-hit CHANGELOG.md path.Follows up on #2070 (versioned-docs canonical); together these address the two P0 technical-SEO items from the GSC/Matomo analysis.