PRDCT-572: consolidated dev→help redirect map + conservation checker (re-cut off main) - #1091
Draft
Iamfle4ka wants to merge 2 commits into
Draft
PRDCT-572: consolidated dev→help redirect map + conservation checker (re-cut off main)#1091Iamfle4ka wants to merge 2 commits into
Iamfle4ka wants to merge 2 commits into
Conversation
Re-cut off main: the original branch was stacked on the closed phase-1/phase-2 chain, so it carried 16 superseded commits and a merge-base from 2026-07-08. Refreshed against main since: - Variables rows point at /components/variables/ — the section owners settled (Matyas 08-04, Jordan 08-05: variables are a base component), executed in #1051. - The 59 Keboola-as-Code rows are surfaced as an open question rather than left asserting a home that exists nowhere: #1027 died and #1015 gave /cli/ to kbagent. - --build no longer accepts a live dev path as conservation when the row moves; an unrelated page can occupy that URL, which is exactly what /cli/* does today. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This was referenced Aug 19, 2026
…t it at /storage/api/ The row said MERGE → /storage/, but #1053 factually landed the dev page's technical layer (API intro + clients) at /storage/api/ with a clients/ tree. A /storage/ 301 would strand readers one level short of the content. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Iamfle4ka
pushed a commit
that referenced
this pull request
Aug 19, 2026
The dev Storage page's content (API intro + clients) lives on this page now, but only /integrate/storage/api/ was redirected — the bare URL resolved nowhere. Found by the redirect contract's conservation check (#1091). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.
Linear: PRDCT-572 · Re-cut off
main, replaces #1043 (same content, no dead base).#1043 was based on
PRDCT-560-devdocs-link-cleanup— a branch belonging to a closed PR in the abandoned phase-1/phase-2 stack. It carried 16 superseded commits and a merge-base from 2026-07-08, so it could never have merged anywhere useful. This is the same deliverable re-cut offmain, exactly as #1051–#1054 were.What it adds
The dev-domain retirement contract as a checkable artifact — today that truth is scattered across PLACEMENT-MAP, MIGRATION-REPORTs and batch PRs, and the in-build redirects are meta-refresh pages, not 301 rules.
PLACEMENT-MAP.md— 175/175 dev pages mapped_data/redirects/dev-to-help.tsv— generated, never hand-editedscripts/check-redirects.mjs—--gen·--build(conservation gate) ·--flippable·--live(cutover day)Refreshed against a month of
mainVariables rows now point at
/components/variables/. The map still said Transformations; the owners settled it since (Matyáš 08-04: variables are a base component with no location constraint; Jordan 08-05), and #1051 executes it.The checker accepted false conservation — fixed.
--buildcounted a row as safe if either the dev path or the final target resolved. For a row that moves, a live dev path can be an unrelated page occupying that URL — which is precisely/cli/*today: kbagent sits there, so three Keboola-as-Code rows were reported "pending" while a reader following them lands on a different tool's docs. Conservation now requires the final target, except for identity redirects. The honest count went 117 → 120.The finding that needs a call: 59 Keboola-as-Code pages have no home
Added to the map's UNSURE section rather than answered, since placement is not mine to make:
/cli/keboola-as-code/**, a tree that exists in no branch and no open PR — PRDCT-470: phase-1 dev-docs migration — one script run (165 pages) #1027 (phase 1) was closed, and PRDCT-490: new top-level CLI section — kbagent #1015 gave/cli/to kbagent.cli/index.mdstill sends readers to the livedevelopers.keboola.com/cli/for the legacy tool.The page already carries
TODO(human-review, Jordan)on the KaC deprecation timeline — this is the same decision: port them under/cli/keboola-as-code/, or declare end-of-life and 301 the lot to/cli/?Expected state of the gate
--buildcurrently fails: 120 of 175 dev URLs resolve nowhere onmain, because the four batch PRs (#1051–#1054) are still open and phase-1's redirect pages died with #1027. That failure is the artifact's value — it quantifies the gap. It goes green as the batches land; the 59 CLI rows will not, until the question above is answered.--flippablereports 29 dev-domain links in content whose target already lives on help — a separate mechanical follow-up, not included here.🤖 Generated with Claude Code