Skip to content

Docs: fix the drift found by the weekly audit (PQ retrain, wheel size, broken fragment links, test and version instructions, CI descriptions) - #366

Merged
tae898 merged 1 commit into
mainfrom
docs/hygiene-20261111
Nov 10, 2026
Merged

tae898 merged 1 commit into
mainfrom
docs/hygiene-20261111

Conversation

@tae898

@tae898 tae898 commented Nov 10, 2026

Copy link
Copy Markdown
Collaborator

Refs #365. I fixed the drift that the weekly audit of the bindings docs and the development and testing docs found and that a text edit can fix. The rest is listed on the issue.

  • vectors.adoc: the statement that every PRODUCT graph rebuild retrains the codebook is replaced by the 26.11.1 behavior: the codebook is kept and retrained past arcadedb.vectorIndex.pqRetrainGrowthFactor or pqRetrainErrorRatio, with the defaults read from the engine source of the 26.11.1 tag.
  • installation.adoc: the native wheel size is stated from the PyPI file size.
  • Five fragment links that did not resolve now use the real ids, checked against the built site. Antora does not check fragments, so the docs build stayed green and the reader landed at the top of the page. One more broken link in dataframes-and-columns.adoc is fixed the same way.
  • README.md, CONTRIBUTING.md, tests/README.md and examples/README.md: the test command is the uv run --no-project --with ... python -m pytest form the repository uses, the version strings follow scripts/dev_engine_pin.json, and the commands use uv.
  • ci.adoc, release.adoc and the issue and pull request templates: the path lists, job descriptions, display names and the SNAPSHOT statement match the workflows.

The docs build (the command of "Build docs site") exits 0 with no warnings, all the fragment links of the docs resolve against the built site, and the added lines have no em dashes and no pip install.

🤖 Generated with Claude Code

Bindings docs: the PRODUCT codebook is kept across graph rebuilds since 26.11.1
(ArcadeData/arcadedb#10847, settings and defaults read from GlobalConfiguration.java
at tag 26.11.1); native wheel size is about 66 MB (PyPI JSON, manylinux_2_28_x86_64 of
26.11.1.post2); five fragment links now use the ids Antora generates (idprefix '',
idseparator '-'), and the result-set link uses its explicit anchor
result-set-single-pass (also in dataframes-and-columns.adoc); the 26.11.1.devN
sentence in bulk-loads.adoc is gone (no such pre-release is on PyPI).

Development docs: README, CONTRIBUTING, tests/README, examples/README, ci.adoc and
release.adoc now match the workflows and scripts (test commands, native build home,
SNAPSHOT rule of a release run, native path filter, push and nightly gating, the
native examples job, assign-maintainer.yml, JVM crash artifacts, workflow display
names, ARCADEDB_TAG example 26.12.1-SNAPSHOT from scripts/dev_engine_pin.json,
NATIVE_NOT_APPLICABLE and WINDOWS_NOT_APPLICABLE, install commands with uv).
The native path list in ci.adoc uses +...+ so that ** no longer renders as bold.

Docs and markdown only; no code, script or workflow file changed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@tae898
tae898 merged commit 7e05787 into main Nov 10, 2026
44 checks passed
@tae898
tae898 deleted the docs/hygiene-20261111 branch November 10, 2026 16:39
@github-actions github-actions Bot added this to the 26.12.1 milestone Nov 10, 2026
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