Skip to content

Added redirects for frequently hit 404 URLs - #196

Merged
JohnONolan merged 1 commit into
mainfrom
autopilot/faec0f1e
Nov 2, 2026
Merged

JohnONolan merged 1 commit into
mainfrom
autopilot/faec0f1e

Conversation

@mintlify

@mintlify mintlify Bot commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Problem: Old URLs from the legacy ghost.org/docs site, the July 2025 docs/ route restructure and the July 2025 theme helper move still got 404s in the last 30 days.

Solution: Added 17 exact redirects in docs.json, each one going to the page that replaced the old URL. mint broken-links --check-anchors --check-redirects --check-snippets passes.

Path Hits (30d) Destination Reason
/api/content 40 /content-api Legacy Content API URL
/docs/install 7 /install Renamed in "Restructure routes" (2ff0d83)
/v1.0.0/docs/config 6 /config Old versioned config page, same topic
/api/gatsby 5 /jamstack/gatsby Legacy Gatsby URL
/docs/config 4 /config Renamed in 2ff0d83
/docs/install-local 4 /install/local Legacy local install slug
/installation 4 /install Near miss
/docs/dynamic-routing 4 /themes/routing Page title "URLs & Dynamic Routing"
/v1/docs/install 4 /install Old versioned install page
/docs/upgrade 4 /update Legacy update guide
/themes/helpers/tags 4 /themes/helpers/data/tags Renamed in e6acebc
/api/ghost-cli 3 /ghost-cli Legacy Ghost-CLI URL
/docs/supported-node-versions 3 /faq/node-versions Page title "Supported Node Versions"
/api/handlebars-themes/routing/collections 3 /themes/routing Collections section of routing page
/api/admin 3 /admin-api Legacy Admin API URL
/v1.0.0/docs/ghost-cli 3 /ghost-cli Old versioned Ghost-CLI page
/themes/helpers/is 3 /themes/helpers/functional/is Renamed in e6acebc

Skipped (no clear destination): /docs/troubleshooting (9), /docs (6), /mail (5), /docs/using-a-custom-storage-module (4), /integrations (4), /content-api/javascript/filtering (4), /v1/docs/working-with-ghost (4), /themes/translation (3), /api (3), /concepts/config (3), and a few other 3-hit paths. Version-prefixed pages for removed features (npm module, v0.11 background start) also get no redirect.

Most of these hits come with an aocr.org referrer or from crawlers. The redirects still help anyone following those old links.

@mintlify
mintlify Bot requested a review from JohnONolan November 2, 2026 12:37
@mintlify

mintlify Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Ghost 🟢 Ready View Preview Nov 2, 2026, 12:38 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: f1d998c7-75bc-4bc9-b92e-52860b1ee3a5

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

@JohnONolan
JohnONolan merged commit 6b58293 into main Nov 2, 2026
8 checks passed
@JohnONolan
JohnONolan deleted the autopilot/faec0f1e branch November 2, 2026 12:38

This branch was successfully deployed

1 active deployment
staging — 3f0f9a22 Deployed Nov 2, 2026 by mintlify[bot]
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