Skip to content

Add wildcard redirects for retired doc versions (v22.2 and earlier)#22931

Open
ebembi-crdb wants to merge 1 commit intomainfrom
fix/retired-version-redirects
Open

Add wildcard redirects for retired doc versions (v22.2 and earlier)#22931
ebembi-crdb wants to merge 1 commit intomainfrom
fix/retired-version-redirects

Conversation

@ebembi-crdb
Copy link
Contributor

Summary

  • Adds Netlify wildcard redirect rules for all retired CockroachDB doc versions (v1.0 through v22.2) to redirect to the equivalent stable/ page
  • Fixes user-reported 404: https://www.cockroachlabs.com/docs/v22.2/cockroach-start

Versions v23.1 and later are actively hosted. Everything v22.2 and older has no doc directory in the repo, so any inbound link to those versions returns a 404. The wildcard rules send visitors to the same page path under stable/ instead.

No internal links in the codebase point to retired version pages — this is purely an inbound SEO/UX fix.

Test plan

  • Verify https://deploy-preview-XXXX--cockroachdb-docs.netlify.app/docs/v22.2/cockroach-start redirects to .../docs/stable/cockroach-start
  • Verify other retired version paths (e.g. /docs/v21.2/show-tables) also redirect correctly
  • Verify active version paths (e.g. /docs/v23.1/cockroach-start) are unaffected

Versions v22.2 and earlier are no longer hosted in the docs site,
causing inbound links to return 404. Reported via user feedback:
  https://www.cockroachlabs.com/docs/v22.2/cockroach-start

Add Netlify wildcard redirect rules for all retired versions
(v1.0 through v22.2) pointing :splat to the equivalent stable page,
so existing bookmarks and external links land on current docs.
@ebembi-crdb ebembi-crdb requested a review from a team as a code owner March 3, 2026 11:16
@netlify
Copy link

netlify bot commented Mar 3, 2026

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 95b8291
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/69a6c3154312e50007484ae5

@github-actions
Copy link

github-actions bot commented Mar 3, 2026

Files changed:

  • src/current/_redirects

@netlify
Copy link

netlify bot commented Mar 3, 2026

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 95b8291
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/69a6c31527dcfa00080632f9

@netlify
Copy link

netlify bot commented Mar 3, 2026

Netlify Preview

Name Link
🔨 Latest commit 95b8291
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/69a6c3153a7b43000817626f
😎 Deploy Preview https://deploy-preview-22931--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@taroface
Copy link
Contributor

taroface commented Mar 3, 2026

Thanks @ebembi-crdb. Do we handle the case where the equivalent path does not exist on stable?

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