Address known bug in redirects and clean up unneeded ones#781
Merged
Conversation
Changes to [public/_redirects](public/_redirects): **1. Reordered** — all 9 dynamic/splat rules moved to the very end of the file, after every static rule. This is likely the actual fix for "some redirects fail" (Cloudflare Pages has a known bug where interspersed dynamic rules cause static rules after them to be silently dropped). **2. Removed 16 lines** (8 unique paths × slash/no-slash) for AWS services LocalStack no longer documents at all — QLDB, MediaStore (+ `-data`), Elastic Transcoder. These redirected to non-existent pages either way; now they 404 directly instead of via a dead redirect. **3. Fixed 52 lines** (26 unique broken targets × slash/no-slash) where the destination had rotated out from under the redirect — renamed services (`kinesisanalytics`→`kinesisanalyticsv2`, `resource_groups`→`resource-groups`), a restructured SDK path (extra `/net/` segment, `python`→`python-boto3`), and pages that moved again during later reorganizations (chaos-engineering, security-testing, lambda-tools, cloud-sandbox, app-frameworks, testing, help-support, etc.). Net: 1,143 → 1,127 rules. Verified against a fresh `astro build` and one live check against docs.localstack.cloud — no new build errors introduced (one pre-existing, unrelated broken link in `elb.mdx` remains, not something I touched). I did **not** touch the ~560 trailing-slash duplicate pairs — I initially suspected these were bloat, but testing live confirmed Cloudflare doesn't normalize trailing slashes, so removing them would reintroduce real 404s. Resolves [DOC-348](https://linear.app/localstack/issue/DOC-348/research-the-current-state-of-redirects)
remotesynth
requested review from
HarshCasper and
quetzalliwrites
as code owners
Deploying localstack-docs with
|
| Latest commit: |
33fa5a1
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://1d5a8582.localstack-docs.pages.dev |
| Branch Preview URL: | https://doc-308-fix-failing-redirect.localstack-docs.pages.dev |
quetzalliwrites
approved these changes
Jul 14, 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
2 participants
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.
Changes to public/_redirects:
1. Reordered — all 9 dynamic/splat rules moved to the very end of the file, after every static rule. This is likely the actual fix for "some redirects fail" (Cloudflare Pages has a known bug where interspersed dynamic rules cause static rules after them to be silently dropped).
2. Removed 16 lines (8 unique paths × slash/no-slash) for AWS services LocalStack no longer documents at all — QLDB, MediaStore (+
-data), Elastic Transcoder. These redirected to non-existent pages either way; now they 404 directly instead of via a dead redirect.3. Fixed 52 lines (26 unique broken targets × slash/no-slash) where the destination had rotated out from under the redirect — renamed services (
kinesisanalytics→kinesisanalyticsv2,resource_groups→resource-groups), a restructured SDK path (extra/net/segment,python→python-boto3), and pages that moved again during later reorganizations (chaos-engineering, security-testing, lambda-tools, cloud-sandbox, app-frameworks, testing, help-support, etc.).Net: 1,143 → 1,127 rules. Verified against a fresh
astro buildand one live check against docs.localstack.cloud — no new build errors introduced (one pre-existing, unrelated broken link inelb.mdxremains, not something I touched).I did not touch the ~560 trailing-slash duplicate pairs — I initially suspected these were bloat, but testing live confirmed Cloudflare doesn't normalize trailing slashes, so removing them would reintroduce real 404s.
Resolves DOC-348