Skip to content

Docs for 26.11.1.post3: the four glue changes with their measured figures, and the stale statements (refs #315) - #399

Merged
tae898 merged 1 commit into
mainfrom
docs/post3
Nov 14, 2026
Merged

tae898 merged 1 commit into
mainfrom
docs/post3

Conversation

@tae898

@tae898 tae898 commented Nov 14, 2026

Copy link
Copy Markdown
Collaborator

What does this PR do?

I update the user docs for 26.11.1.post3, which has been on PyPI since 2026-11-14 for both packages. The four glue changes of the release are described where a reader looks for them, with the measured figures of the release gate: JVM iter_dicts() parses a batch with no tagged value without the object hook (#382), JVM insert_arrow and insert_dataframe carry a timestamp or date column as one long[] of epoch ticks (#383), native begin, commit, rollback, with db.transaction() and is_transaction_active() get the transaction state as one integer (#384), and native save() of a saved record skips the transaction check with auto-transaction on (#385). The engine is unchanged.

This PR is a draft because the pages describe code that is on the tag 26.11.1.post3 and not yet on main. It is ready once #387 (the merge of the post3 line into main) is merged. The branch is based on main, not on the tag, because main has 24 doc pages and the tag has 16. The PR changes no code.

The pages:

  • how-to/bulk-loads.adoc: how a timestamp or date column crosses on the JVM package, with the figures for insert_arrow and insert_dataframe, the insert_columns figure that shows no claim, and the peak resident size, which was higher with the new path.
  • how-to/databases-and-queries.adoc: the iter_dicts() change with its three figures, and the stale save() sentence that said three calls without the auto-transaction case.
  • how-to/transactions.adoc: a new section on what a transaction costs on the native build, with three figures.
  • how-to/dataframes-and-columns.adoc: one sentence that points to the bulk-loads page for the difference between the packages.
  • how-to/concurrency.adoc and quickstart.adoc: the version that the pages name (26.11.1.post3).

The repository has no changelog or release-notes page, so there is nothing to add for the earlier entries' format. The GitHub Release of each tag is generated by release-notes.yml.

What I verified

The behavior text comes from the diff of the tag 26.11.1.post3 against 26.11.1.post2 (results.py, dataframe.py, core.py, TemporalColumn.java, DocumentBatcher.java, _native/database.py, _native/lib.py, _native/records.py, ArcadeNative.java) and from the tests of those changes.

Every figure was copied by script from the scored gate study and checked against the text of my comment of 2026-11-14 on #315, so each ratio on the pages is one that the issue shows. The pages state the conditions: per operation, one Linux x86_64 laptop with two cores, Python 3.12, ABBA order, 20 clean pairs, an A/A control, and the wheels that CI built from the tagged commit. The published wheels were checked for the same engine as 26.11.1 and were not timed again. The pages claim nothing for to_list() (its figures did not resolve), nothing for memory, and nothing for save() with auto-transaction on.

One correction to my comment on #315: it labels the native set() and save() figure as auto-transaction on. The study script never calls set_auto_transaction, so that figure ran with auto-transaction off, and the transactions page says so.

quickstart.adoc ran on Python 3.12 against the published arcadedb 26.11.1.post3 and arcadedb-jvm 26.11.1.post3, and all three scripts printed the output on the page. The local Antora 3.2.1 build with docs/antora-playbook.yml exits 0 with no warning. uvx pre-commit run --files on the six files passes; its Python, YAML and shell hooks have no file to check here.

I did not change the kill probe sentence in bulk-loads.adoc ("It has not been run on 26.11.1.post2"). It is still true, and I have no run of it on post3.

Related issues

Refs #315

Performance changes

None in the code. The figures on the pages are the ones of the release gate in #315.

Docs

The pages listed above.

Checklist

  • A regression test fails on the old code and passes on the new: not applicable, docs only
  • The test suite that the change can affect passes: no code or Python block changed, and the Docs workflow of this PR is the check
  • uvx pre-commit run --files <changed files> passes

🤖 Generated with Claude Code

…, and the stale statements (refs #315)

JVM iter_dicts parses a batch with no tagged value without the object hook (#382); JVM insert_arrow and insert_dataframe carry a timestamp or date column as one long[] of epoch ticks (#383); native transaction calls return the state as one integer (#384); native save() of a saved record with auto-transaction on skips the transaction check (#385). The figures are copied by script from the scored gate study and each is checked against the public comment on #315. The n_update_one figure ran with auto-transaction off, so the page says off (the comment says on). The save() paragraph said three calls without the auto-transaction case. The quickstart was re-run on both published 26.11.1.post3 packages on Python 3.12 and printed the output shown.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@tae898 tae898 added documentation Improvements or additions to documentation python Pull requests that update python code labels Nov 14, 2026
@tae898 tae898 self-assigned this Nov 14, 2026
@tae898
tae898 marked this pull request as ready for review November 14, 2026 07:14
@tae898
tae898 merged commit c3ac563 into main Nov 14, 2026
6 checks passed
@tae898
tae898 deleted the docs/post3 branch November 14, 2026 07:14
@github-actions github-actions Bot added this to the 26.12.1 milestone Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation python Pull requests that update python code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant