Skip to content

PRDCT-658: flip dev-domain links whose targets already live on help - #1094

Open
Iamfle4ka wants to merge 2 commits into
mainfrom
PRDCT-658-flip-dev-links
Open

PRDCT-658: flip dev-domain links whose targets already live on help#1094
Iamfle4ka wants to merge 2 commits into
mainfrom
PRDCT-658-flip-dev-links

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Linear: PRDCT-658 · mechanical follow-up from the redirect contract in #1091.

What

25 developers.keboola.com links flipped to in-repo paths across 14 files — every link whose target already resolves on main, per check-redirects.mjs --flippable, plus two the checker is blind to (pre-rename /extend/docker/running/… URLs that predate the 175-row map; flipped to the canonical /extend/component/running/#running-transformations).

Anchors are preserved, not dropped — the checker's naive suggestions lose them. All six flipped anchors verified present in the built HTML (#component, #generic-extractor, #component-types, #running-transformations, #generate-action, #data-type-conversions). One malformed dev anchor (#generic-extractor/) fixed on the way. One judgment rewrite: [technical differences](…/extend/custom-science/#technical-differences) — that path is now a redirect stub, which drops anchors, and the heading no longer exists; reworded to point at /extend/component/#component-types.

Deliberately NOT flipped — still reported by --flippable (7)

Links Why
3 × SSH-tunnel links in database/{index,mysql,postgresql} #1019 owns exactly those files; flipping here would conflict
3 × /integrate/storage/ + tokens' [Storage API](…/integrate/) their real home is /storage/api/ (+ clients/), which lands with #1053 — flipping to /storage/ today strands them one level short and nothing would ever re-flag them

Also untouched: 12 files linking dev /overview/api/ (UNSURE row, gated on PRDCT-550), /cli/ (home lands with #1093), and 3 generic-extractor links (land with #1054).

Verification

  • npm run build clean; audit broken-internal-links 40 → 35 (flips fixed five; every remaining one pre-dates this PR)
  • --flippable after: exactly the 7 skipped links, nothing new
  • All flipped targets exist in dist/; all kept anchors grep-verified

🤖 Generated with Claude Code

25 links across 14 files, found by check-redirects.mjs --flippable (#1091)
plus two checker-blind cases (pre-rename /extend/docker/running/ URLs absent
from the 175-row map). Anchors preserved where the target heading exists and
verified in dist; one dead dev anchor (#technical-differences, now a redirect
stub that would drop it) reworded to /extend/component/#component-types.

Deliberately NOT flipped, still reported by --flippable:
- 3 SSH-tunnel links in database pages — #1019 owns those files
- 4 /integrate/storage-family links — their real home is /storage/api/,
  which lands with #1053; /storage/ today would strand them one level short

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

linear-code Bot commented Aug 19, 2026

Copy link
Copy Markdown

PRDCT-658

@vercel

vercel Bot commented Aug 19, 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 Aug 27, 2026 8:10pm

Request Review

keboola-pr-reviewer-bot

This comment was marked as outdated.

@Iamfle4ka
Iamfle4ka marked this pull request as ready for review August 26, 2026 17:27

@keboola-pr-reviewer-bot keboola-pr-reviewer-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: auto_approve (risk 2/5) · profile connection-docs

Auto-approve: content-only dev-domain link flips, all targets and anchors verified present at HEAD.

Concerns:

  • src/content/docs/components/writers/storage/aws-s3/index.md: Whole-file line-ending/whitespace churn with identical prose; will noise up git blame.

@keboola-pr-reviewer-bot
keboola-pr-reviewer-bot dismissed their stale review August 26, 2026 17:29

Dismissing prior approval — superseded by a fresh review on this PR.

# Conflicts:
#	src/content/docs/components/extractors/other/generic/generic.md
#	src/content/docs/transformations/index.md
#	src/content/docs/transformations/mappings/index.md
@keboola-pr-reviewer-bot
keboola-pr-reviewer-bot dismissed their stale review August 27, 2026 20:09

Dismissing prior approval — a new commit was pushed and this review was for an earlier SHA. Run @keboola-pr-reviewer-bot review to get a fresh verdict.

@keboola-pr-reviewer-bot

Copy link
Copy Markdown

New commit on e6e042c — dismissed 1 stale bot approval. Comment @keboola-pr-reviewer-bot review when you want a fresh review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent-approved:connection-docs dev-docs-migration developers.keboola.com → help.keboola.com migration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants