Skip to content

fix(redirects): restore /installation as a redirect to the docs - #537

Open
fzipi wants to merge 2 commits into
mainfrom
fix/installation-alias-redirect
Open

fix(redirects): restore /installation as a redirect to the docs#537
fzipi wants to merge 2 commits into
mainfrom
fix/installation-alias-redirect

Conversation

@fzipi

@fzipi fzipi commented Aug 17, 2026

Copy link
Copy Markdown
Member

what

Adds /installation (and /installation/) to static/_redirects, pointing at
/docs/1-getting-started/1-1-crs-installation/ with a 301.

why

/installation was linked from a lot of blog posts before the documentation moved to the subsite,
and has returned 404 ever since:

https://coreruleset.org/installation                               404
https://coreruleset.org/docs/1-getting-started/1-1-crs-installation/  200

This is the third bullet of #64. A Hugo alias in the documentation repo cannot fix it: the docs are
a separate Hugo build with baseURL .../docs/, so an alias for /installation is emitted at
/docs/installation/, not at the site root. Cloudflare Pages path redirects can, and
static/_redirects is already used exactly this way for the community call links.

details

  • Both the slashed and unslashed forms are listed: Cloudflare matches the path literally, and the
    docs treat /trailing and /notrailing/ as separate rules.
  • 301 is explicit because the file's default status is 302 — worth knowing for the existing
    /register/* lines, which are currently temporary redirects.
  • Only /installation is included here. If other legacy top-level paths are worth preserving they
    can go in the same block.

caveat

The destination embeds the docs' numbered path, so reorganising the documentation would leave this
pointing at a 404 without anything noticing — _redirects is a plain file, so the lychee link
checker does not crawl it.

Summary by CodeRabbit

  • Bug Fixes
    • Added permanent redirects from legacy /installation paths to the documentation installation page.
    • Ensures existing links continue to reach the correct installation guidance.

`/installation` was widely linked from blog posts before the documentation
moved to the subsite, and has returned 404 ever since. The page now lives at
/docs/1-getting-started/1-1-crs-installation/.

A Hugo alias in the documentation repo cannot cover this: the docs are a
separate build with baseURL /docs/, so an alias for /installation emits at
/docs/installation/. Cloudflare Pages path redirects can, and static/_redirects
is already used this way for the community call links.

Both the slashed and unslashed forms are listed because Cloudflare matches the
path literally, and 301 is explicit because the file's default is 302.

Refs #64

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 8df9f4ec-fa2b-47ae-856b-e0f4643c41c0

📥 Commits

Reviewing files that changed from the base of the PR and between db31804 and fd7d73a.

📒 Files selected for processing (1)
  • static/_redirects

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

The redirect configuration now maps /installation and /installation/ to the documentation installation page with permanent redirects.

Changes

Installation redirects

Layer / File(s) Summary
Legacy installation path redirects
static/_redirects
Added documented 301 redirects for /installation and /installation/ to /docs/1-getting-started/1-1-crs-installation/.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to fd7d7

This localized change restores permanent redirects for the legacy installation URLs to the documentation page, with no actionable merge-blocking risk remaining beyond normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes restoring the /installation redirect, which is the main change in the pull request.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 17, 2026

Copy link
Copy Markdown

Deploying website with  Cloudflare Pages  Cloudflare Pages

Latest commit: fd7d73a
Status: ✅  Deploy successful!
Preview URL: https://e40b5a07.website-1u6.pages.dev
Branch Preview URL: https://fix-installation-alias-redir.website-1u6.pages.dev

View logs

@fzipi
fzipi enabled auto-merge August 20, 2026 12:23
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