Skip to content

docs(ducklake): correct the embedded DuckDB version per release line - #2187

Merged
lukekim merged 1 commit into
trunkfrom
fix/ducklake-duckdb-version-per-release
Sep 10, 2026
Merged

lukekim merged 1 commit into
trunkfrom
fix/ducklake-duckdb-version-per-release

Conversation

@claudespice

Copy link
Copy Markdown
Contributor

Summary

The DuckLake pages claim DuckDB 1.5.3. That value is right only for the v2.0.x line; every other release line embeds a different DuckDB, and trunk embeds 1.4.4.

Cargo.toml on trunk is explicit about the mapping between the duckdb crate version and the DuckDB library version, which is what makes this checkable — the crate versions are not the DuckDB versions:

duckdb = "1.4.4" # the crate version that matches DuckDB v1.4.4
duckdb = { git = "https://github.com/spiceai/duckdb-rs.git", rev = "9d7be742…" } # branch: spiceai-1.4.4 (DuckDB v1.4.4, arrow 58; …)

Reading that comment at each release tag gives:

Release line Tags Embedded DuckDB Docs said Verdict
vNext (trunk) — 1.4.4 1.5.3 (catalog page) wrong
v2.2.x v2.2.1 / v2.2.0 1.4.4 / 1.5.5 1.5.3 wrong
v2.1.x v2.1.2–v2.1.5 / v2.1.0–v2.1.1 1.5.5 / 1.5.3 1.5.3 wrong for v2.1.2+
v2.0.x v2.0.0 / v2.0.1 1.5.3 1.5.3 correct — left unchanged

The vNext connector page was corrected to 1.4.4 in #2186; this PR sweeps the sibling catalog page it missed, plus every versioned snapshot that carries the same claim.

What changed

  • website/docs/components/catalogs/ducklake.md — 1.5.3 → 1.4.4, wording matched to the connector page docs: reconcile the docs with the runtime changes since v2.2 #2186 already fixed.
  • versioned_docs/version-2.2.x/ (connector + catalog) — "Spice v2.2.1 embeds DuckDB 1.4.4; v2.2.0 embeds DuckDB 1.5.5".
  • versioned_docs/version-2.1.x/ (connector + catalog) — "Spice v2.1.2 and later embed DuckDB 1.5.5; v2.1.0 and v2.1.1 embed DuckDB 1.5.3".

The version changed inside the 2.1.x and 2.2.x lines, so a single flat number is wrong for part of each line's readership — hence the per-patch wording rather than just swapping one digit.

Source refs

Out of scope

The versioned pages also assert "which supports DuckLake 1.0". #2186 dropped that clause from the vNext connector page rather than restate it, and I have no runnable evidence for which DuckLake catalog version each DuckDB build accepts, so I left the clause alone on the snapshots instead of guessing.

Test plan

  • cd website && npm run build passes
  • Versioned-docs propagation checked: grep -rn "DuckDB 1.5.3" website/ now returns only the two v2.0.x files, which are correct
  • Files updated: 5

Spice embeds DuckDB v1.4.4 on trunk (spiceai/spiceai#13742 downgraded it from
1.5.5 on 2026-08-30, shipping in v2.2.1). The DuckLake pages claimed 1.5.3.

- vNext catalog page: 1.5.3 -> 1.4.4 (mirrors the connector page fixed in #2186)
- version-2.2.x: v2.2.1 embeds 1.4.4, v2.2.0 embeds 1.5.5
- version-2.1.x: v2.1.2+ embeds 1.5.5, v2.1.0/v2.1.1 embed 1.5.3
- version-2.0.x left unchanged: v2.0.0/v2.0.1 really do embed 1.5.3
@github-actions

github-actions Bot commented Sep 10, 2026 •

Copy link
Copy Markdown
Contributor

✅ Pull with Spice Passed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected
  • ✅ Has at least one assignee: claudespice

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Pull with Spice Failed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected

Failed checks:

  • ❌ At least one assignee is required for this pull request.

Please address these issues and update your pull request.

1 similar comment
@github-actions

Copy link
Copy Markdown
Contributor

🔍 Pull with Spice Failed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected

Failed checks:

  • ❌ At least one assignee is required for this pull request.

Please address these issues and update your pull request.

@github-actions

Copy link
Copy Markdown
Contributor

🚀 deployed to https://0210e389.spiceai-org-website.pages.dev

@lukekim
lukekim merged commit 1d884f2 into trunk Sep 10, 2026
8 of 15 checks passed
@lukekim
lukekim deleted the fix/ducklake-duckdb-version-per-release branch September 10, 2026 15:07
lukekim pushed a commit that referenced this pull request Sep 12, 2026
The version-2.3.x snapshot was cut hours before #2187 corrected the
embedded DuckDB version per release line, so its catalog page still
claims DuckDB 1.5.3 while the connector page in the same snapshot
already says 1.4.4. v2.3.0's Cargo.toml pins the crate whose comment
names DuckDB v1.4.4.

This branch was successfully deployed

1 active deployment
preview — fd65877b Deployed Sep 10, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants