Skip to content

PRDCT-543: migrate dev extend/ into help (component building) - #1025

Closed
Iamfle4ka wants to merge 1 commit into
mainfrom
docs/devdocs-migrate-extend
Closed

Iamfle4ka wants to merge 1 commit into
mainfrom
docs/devdocs-migrate-extend

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Draft — Track B, top-down. Ports the entire dev extend/ section (84 pages, 147 images) onto the platform at its existing /extend/ paths: component building, Common Interface, Generic Extractor, Generic Writer, Job Queue, Marketplace publishing. Same-path migration (dev /extend/ == help /extend/), so no redirects needed.

Conservation

Every dev extend/ page ported 1:1 (mechanical port, no rework). Non-.md/image assets and Jekyll includes handled:

  • branches-beta-warning.html → :::caution[Public Beta]
  • config-map.json / writer-config-map.json → inlined as static JSON
  • config-events.js / writer-config-events.js (jQuery parameter-map overlay) + their <style> → dropped; the sample config is preserved as a plain code block. Follow-up: the interactive key→anchor "parameter map" is not ported.
  • data.zip sample asset copied to public/extend/; fixed one relative image ref broken by the slug→subdir remap.

Link handling

  • /extend/ internal (all ported); help + in-main sections internal.
  • Kept unmigrated dev sections (/integrate/, /automate/, /cli/, /overview/api, /overview/encryption) as absolute developers.keboola.com URLs — flip when they migrate.
  • Fixed stale paths: /extractors/ → /components/extractors/; S3 extractor other/aws-s3 → storage/aws-s3; storage concept → /storage/.
  • Backlink pass: flipped inbound dev /extend/ links to internal across 14 help pages (home + overview/index left for PRDCT-540: combine dev+help home and overview (top-down pilot) #1022).

Nav

New Extending Keboola top-level group (6 subsection indices). This is a large section — happy to split it at review (e.g. component / generic-extractor / rest) if preferred.

Verification

  • npm run build clean (342 pages). audit-phase2.mjs: 0 missing images, 0 broken links in /extend/ (the 3 flagged are pre-existing on main).
  • Converter used locally and removed — not in this PR.

Track-B remaining after this: cli/ (next), then storage-concept (deferred until Storage rework #1010 merges).

🤖 Generated with Claude Code

Track B, top-down: ports the whole dev extend/ section (84 pages, 147 images) onto
the platform at its existing /extend/ paths — component building, Common Interface,
Generic Extractor, Generic Writer, Job Queue, and Marketplace publishing. Same-path
migration (dev /extend/ == help /extend/), so no redirects needed.

- Converter (migrate-devdocs.mjs, from #1020) used locally to port + removed before
  commit (not in this PR).
- Includes resolved: branches-beta-warning -> :::caution[Public Beta]; config-map.json
  / writer-config-map.json inlined as static JSON; the jQuery config-events.js parameter-
  map overlay + its <style> dropped (interactive key->anchor linking not ported — the
  sample config is preserved as a plain code block).
- Fixed a relative image ref broken by the slug->subdir remap (child_debug.png ->
  absolute public path); copied the non-image sample asset data.zip to public/.
- Link rules: /extend/ internal (all ported); help + in-main sections internal; kept
  unmigrated dev sections (/integrate/, /automate/, /cli/, /overview/api, encryption)
  as absolute developers.keboola.com URLs; storage concept -> /storage/; stale paths
  fixed (/extractors/ -> /components/extractors/; S3 extractor other/ -> storage/).
- Nav: new "Extending Keboola" top-level group (6 subsection indices).
- Backlink pass: flipped inbound dev /extend/ links to internal across 14 help pages
  (home + overview/index left for #1022).

Large section — could be split at review if preferred. Draft, awaiting maintainer review.

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

vercel Bot commented Jul 15, 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 15, 2026 12:57am

Request Review

@Iamfle4ka Iamfle4ka changed the title docs(devdocs): migrate extend/ (component building) into help PRDCT-543: migrate dev extend/ into help (component building) Jul 15, 2026
@linear-code

linear-code Bot commented Jul 15, 2026

Copy link
Copy Markdown

PRDCT-543

@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

This branch was successfully deployed

1 active deployment
Preview — 41e8b24c Deployed Jul 15, 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.

1 participant