Skip to content

PRDCT-572: consolidated dev→help redirect map + conservation checker - #1043

Draft
Iamfle4ka wants to merge 1 commit into
PRDCT-560-devdocs-link-cleanupfrom
PRDCT-572-redirect-map
Draft

PRDCT-572: consolidated dev→help redirect map + conservation checker#1043
Iamfle4ka wants to merge 1 commit into
PRDCT-560-devdocs-link-cleanupfrom
PRDCT-572-redirect-map

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

The developers.keboola.com retirement (PRDCT-565) needs one authoritative "every dev URL → final help URL" table — until now that truth was split across PLACEMENT-MAP.md, migration reports, and batch PRs. This PR makes it a generated, checkable artifact (PRDCT-572).

What's in here

  • _data/redirects/dev-to-help.tsv — the contract, generated from the committed PLACEMENT-MAP.md (don't hand-edit): 175 rows — 156 moved (topic home on help), 12 redirect (dev landing/duplicate → canonical), 6 unsure (final path is the PRDCT-550 proposal), 1 dies (site chrome).
  • scripts/check-redirects.mjs — makes the contract checkable at the three moments that matter:
    • --build — after every batch: every dev path must resolve in dist/ (real page or redirect page), else conservation is broken;
    • --flippable — maintenance: absolute dev-domain links in content whose target already lives on help;
    • --live — cutover day: developers.keboola.com/<path> must actually 301 to the mapped help URL;
    • --gen — regenerate the TSV when PLACEMENT-MAP changes.

Current --build state (on this stack, honest snapshot)

That output is the checker doing its job: the remaining pre-cutover to-do list, enumerated instead of assumed. This TSV is also the hand-off artifact the infra owner needs for the domain-level 301 (PRDCT-565).

Stacked on #1036 (needs PLACEMENT-MAP.md, which lives in the migration stack); merges last in the chain order.

🤖 Generated with Claude Code

One authoritative "every dev URL → final help URL" table, generated from
PLACEMENT-MAP.md into _data/redirects/dev-to-help.tsv (175 rows: 156 moved,
12 redirect-only, 6 unsure pending PRDCT-550, 1 dies). check-redirects.mjs
makes the contract checkable at three moments:
  --build     every dev path resolves in dist (page or redirect) — conservation
  --flippable absolute dev-domain links whose target already lives on help
  --live      cutover day: developers.keboola.com/<path> 301s to the mapped URL
  --gen       regenerate the TSV from the committed map

Current --build state on this stack: 1 known gap (/integrate/data-streams/
overview/ — redirect ships with the #1023 weave) + pending-batch targets
(PRDCT-550) reported as not-built-yet. That is the checker working as
intended: the remaining pre-cutover to-do list, enumerated.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@linear-code

linear-code Bot commented Jul 23, 2026

Copy link
Copy Markdown

PRDCT-572

@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
connection-docs Ready Ready Preview, Comment Jul 23, 2026 7:24pm

Request Review

@Iamfle4ka Iamfle4ka added the dev-docs-migration developers.keboola.com → help.keboola.com migration label Jul 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dev-docs-migration developers.keboola.com → help.keboola.com migration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant