Skip to content

Fix missing items from the top 50 404s - #864

Merged
HarshCasper merged 1 commit into
mainfrom
DOC-398-fix-404-url-redirects
Aug 11, 2026
Merged

Fix missing items from the top 50 404s#864
HarshCasper merged 1 commit into
mainfrom
DOC-398-fix-404-url-redirects

Conversation

@remotesynth

Copy link
Copy Markdown
Collaborator

Reviewed all 50 top 404 URLs from the CSV against public/_redirects. Most were missing redirects (likely from the Cloudflare redirect fix earlier this month), not bad targets.

Summary

Status Count Action
Already redirected (valid) 5 No change needed

Already working (5 URLs)

These had valid redirects in place:

  • /aws/integrations/continuous-integration//aws/ci-pipelines/
  • /aws/integrations/messaging/selfmanaged-kafka-cluster/ → self-managed Kafka doc
  • /aws/enterprise/sso//aws/organizations-admin/sso/
  • /aws/capabilities/extensions/mailhog/ → mailhog extension doc (via splat)
  • /aws/capabilities/networking/internal-endpoints/ → internal endpoints doc

Fixed bad redirect (1 URL)

/aws/capabilities/networking/endpoint-url was caught by the splat rule and sent to /aws/customization/networking/endpoint-url, which does not exist. Added explicit redirects to /aws/customization/networking/accessing-endpoint-url/ (placed before the splat rules).

Added redirects (44 URLs)

High-traffic examples:

404 URL Redirect target
/aws/getting-started/help-support/ (318 PV) /aws/help-support/
/aws/s3/, /aws/sqs/, /aws/iam/, etc. Corresponding /aws/services/*/ pages

Also added variants for paths like /integrations/, /tools/, /ci/, /getting-started/api-key/, contributing subpages, and nested SDK paths (/aws/connecting/aws-sdks/net/ → dotnet).

Build passes with all links valid. After deploy, these 404s should drop off analytics within a few days as Cloudflare picks up the updated _redirects file.

Fixes DOC-398

Reviewed all 50 top 404 URLs from the CSV against `public/_redirects`. Most were missing redirects (likely from the Cloudflare redirect fix earlier this month), not bad targets.

## Summary

| Status | Count | Action |
|--------|-------|--------|
| Already redirected (valid) | 5 | No change needed |
| Redirect existed but target was wrong | 1 | Fixed |
| Missing redirect | 44 | Added |

## Already working (5 URLs)

These had valid redirects in place:

- `/aws/integrations/continuous-integration/` → `/aws/ci-pipelines/`
- `/aws/integrations/messaging/selfmanaged-kafka-cluster/` → self-managed Kafka doc
- `/aws/enterprise/sso/` → `/aws/organizations-admin/sso/`
- `/aws/capabilities/extensions/mailhog/` → mailhog extension doc (via splat)
- `/aws/capabilities/networking/internal-endpoints/` → internal endpoints doc

## Fixed bad redirect (1 URL)

`/aws/capabilities/networking/endpoint-url` was caught by the splat rule and sent to `/aws/customization/networking/endpoint-url`, which does not exist. Added explicit redirects to `/aws/customization/networking/accessing-endpoint-url/` (placed before the splat rules).

## Added redirects (44 URLs)

High-traffic examples:

| 404 URL | Redirect target |
|---------|-----------------|
| `/aws/getting-started/help-support/` (318 PV) | `/aws/help-support/` |
| `/get-started/` (166 PV) | `/aws/getting-started/` |
| `/aws/feature-coverage/` (107 PV) | `/aws/services/` |
| `/references/persistence-mechanism/` (69 PV) | `/aws/developer-tools/snapshots/persistence/` |
| `/localstack/configuration/` (63 PV) | `/aws/customization/` |
| `/aws/enterprise/k8s-operator` (57 PV) | `/aws/customization/kubernetes/kubernetes-operator/` |
| `/developer-guide/` (55 PV) | `/aws/` |
| `/aws/s3/`, `/aws/sqs/`, `/aws/iam/`, etc. | Corresponding `/aws/services/*/` pages |
| `/t/*.html` (3 Discourse URLs) | `https://discuss.localstack.cloud/t/...` |

Also added variants for paths like `/integrations/`, `/tools/`, `/ci/`, `/getting-started/api-key/`, contributing subpages, and nested SDK paths (`/aws/connecting/aws-sdks/net/` → dotnet).

Build passes with all links valid. After deploy, these 404s should drop off analytics within a few days as Cloudflare picks up the updated `_redirects` file.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: fa4c48d
Status: ✅  Deploy successful!
Preview URL: https://61d14d63.localstack-docs.pages.dev
Branch Preview URL: https://doc-398-fix-404-url-redirect.localstack-docs.pages.dev

View logs

@HarshCasper
HarshCasper merged commit fbb0c7e into main Aug 11, 2026
1 of 2 checks passed
@HarshCasper
HarshCasper deleted the DOC-398-fix-404-url-redirects branch August 11, 2026 14:34
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.

2 participants