Conversation
First slice of integrating developers.keboola.com INTO help.keboola.com (one
site). Ports the dev automate/ section faithfully, preserving its URLs, and adds
a reusable converter to scale the rest.
- New scripts/migrate-devdocs.mjs — parameterized Jekyll->Astro converter
(permalink->slug preserving paths, strips {:..}/{:toc}/{%comment%}, converts
{%highlight%}, dual-copies images, collision guard, never prunes).
- Port automate/ (index, run-job, run-orchestration, set-schedule) at their
existing paths; internalize help.keboola.com links; jobs concept -> /management/jobs/.
- New 'API & Automation' nav group (future home for the dev sections).
- overview/api reference link left pointing at dev until overview/ migrates.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Iamfle4ka
changed the title
|
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 |
Review summaryVerdict: merge-ready with nits. Merges first (base = main, Clean pilot (15 files). Four ported pages have valid Nits:
Note: devdocs→help URL 301s are domain-level (separate origin) and out of scope for this repo — confirm those are configured at the Automated review pass (Claude Code), flagged for a human maintainer — not an approval. |
This branch was successfully deployed
2 participants
What
Pilot for integrating
developers.keboola.comintohelp.keboola.com(the end state is one site). Ports the devautomate/section (4 pages) faithfully onto this platform and lands the reusable converter that will scale to the rest of the dev docs.scripts/migrate-devdocs.mjs— parameterized Jekyll→Astro converter:permalink→slug(preserves dev paths), strips{: …}/* TOC {:toc}/{% comment %}, converts{% highlight %}→fenced code, dual-copies images (public + co-located), has a collision guard (won't overwrite an existing help page), and never prunes. Reuses the transform ideas from the legacyscripts/migrate.mjs./automate/,/automate/run-job/,/automate/run-orchestration/,/automate/set-schedule/.help.keboola.com/*→ relative; the dev "Jobs concept" link →/management/jobs/(help canonical concept); Orchestrator →/flows/.extend//cli//integrate/as they migrate).Why this shape
Per the unification playbook, dev content is integrated into help (not kept as a separate site). URL scheme = preserve dev paths (agreed): near-1:1 domain 301s, minimal link churn. This PR validates the converter + scheme on a small section before scaling.
Deferred (by design)
/overview/api/reference link still points atdevelopers.keboola.com— it'll flip to internal when theoverview/section migrates (the "flip inbound links only once the target is migrated" rule).automate/page title is verbatim). Content reconcile with/flows/+/management/jobs/is a later step.Verification
npm run gen:sidebar+npm run build— clean, 262 pages (+4),API & Automationgroup renders.node scripts/audit-phase2.mjs— no new broken links; MISSING IMAGES: 0 for the ported pages; no leftover Jekyll-isms ({% %}/{: }/permalink:). The oneautomate/ → developers.keboola.com/overview/api/seam is the intentional deferred link above.Context
Part of the help + developers unification. The dev-docs repo is connected as the
devdocsremote, so this is the first mechanical port; the converter scales tointegrate/→overview/→cli/→extend/next.🤖 Generated with Claude Code