Skip to content

PRDCT-539: migrate dev integrate/ (clean remainder) into help - #1021

Closed
Iamfle4ka wants to merge 1 commit into
docs/devdocs-migrate-automatefrom
docs/devdocs-migrate-integrate
Closed

Iamfle4ka wants to merge 1 commit into
docs/devdocs-migrate-automatefrom
docs/devdocs-migrate-integrate

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Second slice of unifying developers.keboola.com into help.keboola.com. Ports the genuinely dev-only, not-yet-handled integrate/ pages at their existing URLs; leaves the already-merged and pending-merge topics to their own PRs.

Stacked on #1020 (the automate/ pilot + converter). Base = docs/devdocs-migrate-automate; rebase onto main once #1020 merges.

Ported (converter + manual link/admonition pass)

  • integrate/ landing, artifacts/ (+tutorial), variables/ (+tutorial), storage/api/* (configurations, import-export, importer, tde-exporter), and the Storage API clients (php/python/r/docker-cli).
  • Internalized help.keboola.com links; kept unmigrated dev sections (/extend/, /overview/, job API) as absolute developers.keboola.com URLs — flip when those migrate.
  • Skipped storage concept links point at /storage/.
  • "Preview feature" notes → :::caution[Public Beta]; fixed Jekyll literal-escaping artifacts ({{ "{{ x " }}}} → {{ x }}); inlined the {% include async-create.py %} snippet.
  • Reciprocal cross-link between integrate/variables (API) and transformations/variables (UI concept).

Redirects (301 on the canonical help page)

dev URL → canonical status
/integrate/mcp/ /ai/mcp-server/ done #1001
/integrate/database/ /components/extractors/database/ done #1019
/integrate/jobs/ /management/jobs/ done #1004
/integrate/orchestrator/ /flows/ empty dev stub

Skipped — owned by pending separate merges

Nav & backlinks

  • Extended the API & Automation nav group with the ported pages.
  • Flipped inbound links from help pages (artifacts, storage api/clients) to the new internal paths.

Verification

  • npm run build clean (276 pages; 4 new redirects generated + verified to resolve).
  • node scripts/audit-phase2.mjs: 0 missing images, 0 broken internal links from these pages. The 19 "old-docs link smells" on integrate pages are the intentional absolute dev links to unmigrated sections (13 /extend, 4 job API, 2 /overview).
  • Rendered HTML spot-checked: admonitions render as Starlight asides, moustache renders literally, code blocks + cross-links intact.

Follow-ups

  • Flip the kept developers.keboola.com/{extend,overview} + job-API links once those sections migrate.
  • Converter nit: normalize scalar redirect_from → array (one page needed a manual fix).

🤖 Generated with Claude Code

Second slice of integrating developers.keboola.com INTO help.keboola.com.
Ports the genuinely dev-only, not-yet-handled integrate/ pages at their existing
URLs; leaves the already-merged and pending-merge topics to their own PRs.

Ported (via scripts/migrate-devdocs.mjs, then a manual link/admonition pass):
- integrate/ landing, artifacts/ (+tutorial), variables/ (+tutorial),
  storage/api/* (configurations, import-export, importer, tde-exporter),
  and the Storage API clients (php/python/r/docker-cli).
- Internalize help.keboola.com links; keep unmigrated dev sections
  (/extend/, /overview/, job API) as absolute developers.keboola.com URLs
  (flip when those migrate); point the skipped storage concept at /storage/.
- Convert the "preview feature" notes to :::caution[Public Beta]; fix Jekyll
  literal-escaping artifacts ({{ "{{ x " }}}} -> {{ x }}); inline the
  {% include async-create.py %} snippet.
- Reciprocal cross-link between integrate/variables (API) and
  transformations/variables (UI concept).

Redirects (301 on the canonical help page; already-merged/stub dev URLs):
- /integrate/mcp/ -> /ai/mcp-server/        (done #1001)
- /integrate/database/ -> /components/extractors/database/  (done #1019)
- /integrate/jobs/ -> /management/jobs/      (done #1004)
- /integrate/orchestrator/ -> /flows/        (empty dev stub)

Skipped (owned by pending separate merges): integrate/data-streams/**
(-> /storage/data-streams/) and the storage concept index (-> /storage/).

Nav: extend the "API & Automation" group with the ported integrate/ pages.
Backlinks: flip inbound links from help pages to the new internal paths.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 14, 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 14, 2026 2:39pm

Request Review

@Iamfle4ka Iamfle4ka changed the title docs(devdocs): migrate integrate/ clean remainder onto the platform PRDCT-539: migrate dev integrate/ (clean remainder) into help Jul 15, 2026
@linear-code

linear-code Bot commented Jul 15, 2026

Copy link
Copy Markdown

PRDCT-539

@Iamfle4ka

Copy link
Copy Markdown
Collaborator Author

Superseded: migration is being redone as ONE fully script-driven run (no post-script hand edits), per Jordan's requirement that moves be verifiable by validating the code. This PR's scope (and the hand-fixes discovered here) are encoded into the extended script. Placement map for the later topic re-organization: PLACEMENT-MAP.md / https://claude.ai/code/artifact/5333888d-4577-4915-9fab-37fbf3834d47

@jordanrburger

Copy link
Copy Markdown
Contributor

Review summary

Verdict: content ready with nits — but BLOCKED from reaching main until #1020 merges.

Larger slice (46 files, +2958/-13) porting integrate/ (artifacts, variables, storage API + clients) plus inbound-link flips on 6 existing help pages and 4 new redirects. Frontmatter, slugs (unique under integrate/, no collisions), sidebar wiring, admonitions, code fences, and internal anchors all check out.

Merge order: base is docs/devdocs-migrate-automate (#1020's branch), not main — reports MERGEABLE only relative to that base. Sequence: merge #1020 → GitHub retargets this to main (or rebase manually) → re-verify MERGEABLE → merge. Do not merge this to main first.

Nits:

  • 6 content links still point at absolute developers.keboola.com/integrate/jobs/ while this same PR adds redirect_from: /integrate/jobs/ → /management/jobs/. Either internalize them to /management/jobs/ or keep absolute — but note the #job-polling anchor (one of them) has no equivalent heading in /management/jobs/, which is likely why they were left absolute. Worth a decision so links survive devdocs decommissioning.
  • No description frontmatter on the new pages (same as PRDCT-538: migrate dev automate/ into help (pilot + converter) #1020).

Same domain-level 301 caveat as #1020.

Automated review pass (Claude Code), flagged for a human maintainer — not an approval.

This branch was successfully deployed

1 active deployment
Preview — b4184e0f Deployed Jul 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants