#10264 chore: Stop redirecting away from the DataML and Cloud API reference pages Pull request opened by ReubenFrankel Description 16 reference pages redirected away instead of opening: the whole

/reference/cloud/dataml/

tree went to Which Meltano, and

/reference/cloud/api/resources/news

went to the marketing site. Broken since

c139d24b2

on 7 August 2026. Netlify matches

from

against the request path alone, so a pattern that opens with a splat also matches the parent segments of a real page.

*/dataml/*

bound its splat to

/reference/cloud

and claimed

/reference/cloud/dataml/pipelineml

, and

force = true

made it beat the page that lives there.

*/visualisation/

and

*/news/

did the same to one page each. Changes •

/docs/dataml/*

->

/reference/cloud/dataml/:splat

replaces

*/dataml/*

and three named rules. Anchored, so it cannot reach into the reference tree.

meltanoyml

has no counterpart and keeps its own rule. •

/docs/api/*

->

/reference/cloud/api/:splat

replaces six named rules. The legacy Cloud API tree is an exact 29-page mirror. •

/docs/how-to-guides/manage-workspaces/*

->

/meltano-cloud/managing-a-workspace#:splat

. The four legacy sub-pages became sections of that page, so the splat carries the sub-page name into the anchor. A duplicate rule is removed. •

*/visualisation/

and

*/news/

are removed. Both pointed at the meltano.com home page, and matatika.com routes those paths to the marketing site, so neither served live traffic. •

.gitignore

ignores the local Netlify directory. Verification All 902 built pages were resolved through the full redirect chain: 16 taken over by a redirect before, 0 after. Across 238 archived legacy documentation URLs, no path that resolved before regressed, and 22 legacy Cloud API paths that returned 404 now reach a page. Two deliberate 404s:

<http://docs.meltano.com/visualisation/|docs.meltano.com/visualisation/>

and

/news/

, per the bullet above. Legacy

/dataml/...

links without the

/docs

prefix still 404, because matatika.com strips that prefix; tracked separately. 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 • Closes MEL-622 --- 🤖 Generated with Claude Code meltano/meltano