PRDCT-572: consolidated dev→help redirect map + conservation checker - #1043
Closed
Iamfle4ka wants to merge 2 commits into
Closed
PRDCT-572: consolidated dev→help redirect map + conservation checker#1043Iamfle4ka wants to merge 2 commits into
Iamfle4ka wants to merge 2 commits into
Conversation
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>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Iamfle4ka
added
the
dev-docs-migration
The map still routed the 42 dev /extend/** pages to /components/development/**, a section that was never built: Jordan approved /extend/ as its own top-level section instead (#1046, merged 2026-07-29, commit 8504c9d). Every one of those 42 targets 404'd, so deleting the dev pages would have orphaned their URLs. #1046 preserved the dev path structure 1:1, so these become identity redirects across domains (developers.keboola.com/extend/X/ -> help.keboola.com/extend/X/). Verified: all 42 targets now resolve in a production build; conservation failures drop from 162 to 117, and the remaining 117 are units whose help pages are not on main yet (#1023, #1051-#1054, artifacts, jobs, overview/api, encryption, CLI). The NEW-sections table entry is marked superseded rather than deleted so the provenance of the change stays readable. Left untouched: the 3 rows still targeting /components/development/ (artifacts x2, overview/encryption). They are flagged `unsure` and are genuine open owner calls. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This was referenced Aug 5, 2026
Collaborator
Author
|
Superseded by #1091 — same deliverable re-cut off This branch was based on |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 — 156moved(topic home on help), 12redirect(dev landing/duplicate → canonical), 6unsure(final path is the PRDCT-550 proposal), 1dies(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 indist/(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
--buildstate (on this stack, honest snapshot)/integrate/data-streams/overview/resolves nowhere yet — itsredirect_fromships with the PRDCT-541: merge dev data-streams into /storage/data-streams/ #1023 data-streams weave (verified present on that branch). Closes when PRDCT-541: merge dev data-streams into /storage/data-streams/ #1023 merges.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