PRDCT-342: land the June DB-connector audit fixes that were never applied

[Iamfle4ka]

The June audit found all of this and opened #970 — which was then closed on purpose: "Closing per change of plan: this is an audit-only task. No documentation edits to be merged. Findings will be posted to the Linear issue/document. Branch kept for reference."

The second half of that plan never ran. So every finding below has been live on help.keboola.com for seven weeks. This recovers the kept branch (devin/1781787795-db-extractor-docs-audit) and re-verifies each change against current main — nothing is taken on faith from the June diff.

Wrong component, wrong database

Page	Was	Now
Oracle	links keboola.ex-db-mysql as "this connector"	keboola.ex-db-oracle
PostgreSQL	links keboola.ex-db-mysql	keboola.ex-db-pgsql

Both IDs confirmed to exist via the public Storage API component index, not just by eye.

Also on the PostgreSQL page:

• The credentials list described "the MySQL server" in all four fields — Host, Port, User, Password.
• The CDC section said the connector reads "the binlog". That is MySQL's mechanism; PostgreSQL uses the write-ahead log — which the same page explains correctly a few sections earlier.
• The data-type table was titled "MySQL datatypes are mapped to…".

And on the MySQL page: the column-mask notes linked Debezium's PostgreSQL connector docs. Now the MySQL page — both #mysql-property-column-mask-* anchors verified live.

Broken anchors

/components/extractors/database/sqldb/#create-new-configuration does not exist; the heading is Initial Setup. It was linked from five pages (index, ms-sql, mysql, oracle, postgresql). Also fixed the page-local #log-based-cdc → #postgresql-log-based-cdc.

Wrong screenshot

The Replication Plugin Advanced Options section showed img_4.png — the Heartbeat panel. It now shows img_2.png, which is the publication panel the surrounding text actually describes. Confirmed by opening both images, not by filename.

Migration leftovers

Unrendered Jekyll/AsciiDoc that has been shipping as literal text: {prodname} → Debezium (8×), link: [x](y) and the: [x](y) → plain links, a raw link:url[text], a stray endif::community[]. Plus an unclosed markdown link (SSH tunnel), an unclosed backtick in the ms-sql cdc_get_net_changes link, and 4 absolute https://help.keboola.com/… self-links made root-relative.

Verification

• npm run build clean, 306 pages.
• audit-phase2: 45 broken links / 0 missing images, unchanged from main — and none of the 45 sits on a page touched here. The audit's overall total does improve, 147 → 143, from the four absolute help.keboola.com self-links made root-relative.
• The five anchor fixes deliberately do not move that number: audit-phase2 validates link paths but not anchors. That gap is what the open feat(audit): validate link anchors, not just link paths #1073 closes — worth merging it to keep this class of defect from returning.

Reviewer note

Nothing here needed a product decision — every change is either an internal contradiction on the page itself or checkable against a source (component index, Debezium docs, the images). No VERIFY(owner) flags.

Context: this PR came out of a reconciliation of the June audits against the live sites. The same pass found more still-live findings — swapped OpenAI/Azure auth on the Generative AI page is the sharpest one — which will follow separately.

[linear-code]

PRDCT-342

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
connection-docs	Ready	Preview	Aug 6, 2026 11:40pm