GitHub
08/25/2026, 1:55 AM/docs prefix before the request reaches Netlify, so all 22 rules that matched on a /docs path were unreachable. The redirects have never worked since they were added.
The rules now match the path that Netlify receives. Dropping force = true from the migrated rules also lets a real docs page win over a redirect.
• Strip the /docs prefix from every migrated from path.
• Remove force = true from the migrated rules.
• Replace the per-page rules with #:splat anchor rules for import-data, automate-actions and manage-workspaces.
• Collapse the four snowflake-developer-guides rules into one prefix rule.
• Order the named how-to-guides rules above the catch-all, so that they win.
• Keep /meltano-cloud/cloud-overview as the how-to-guides catch-all target, and add an explicit transform-data rule.
Verified with Netlify's own matcher: all 13 known Matatika how-to-guides slugs reach their intended target, all 3 generated anchors match a real heading, and none of the 902 docs routes is captured by a forced redirect.
A reader who follows an unmapped how-to-guides link now lands on the Meltano Cloud overview instead of a 404.
Checklist
• I have read the contribution guide
Was generative AI tooling used to co-author this PR?
• Yes (please specify the tool below)
Generated-by: Claude Code following the agentic coding guidelines
Related Issues
• Follows #10264, which stopped the forced redirects capturing the DataML and Cloud API reference pages.
Summary by Sourcery
Fix legacy documentation routing by aligning redirects with Netlify paths and improving fallback and page-specific behavior.
Bug Fixes:
• Repair legacy Matatika documentation redirects so they match the paths received by Netlify instead of producing 404s.
• Preserve real documentation pages by removing forced redirects from the migrated rules.
• Route unmapped how-to-guides links to the Meltano Cloud overview rather than a 404.
Enhancements:
• Consolidate documentation redirects with anchor-aware patterns and a single Snowflake guides prefix rule, while ordering specific how-to-guide redirects ahead of the fallback.
---
🤖 Generated with Claude Code
meltano/meltanoGitHub
08/25/2026, 2:12 AM