Skip to content

Docs: quickstart output on 26.11.1.post2, facets pre-release hint, concurrency caveat, ci.adoc bold (refs #365) - #375

Merged
tae898 merged 1 commit into
mainfrom
docs/365-quickstart-facets-ci
Nov 12, 2026
Merged

tae898 merged 1 commit into
mainfrom
docs/365-quickstart-facets-ci

Conversation

@tae898

@tae898 tae898 commented Nov 12, 2026

Copy link
Copy Markdown
Collaborator

Refs #365. Docs only, so the Docs workflow (the Antora build, where a warning fails) is its check.

What I did, item by item of #365:

  • Quickstart: I extracted the three scripts of quickstart.adoc and ran them with uv run --python 3.12 --with arcadedb-jvm==26.11.1.post2 and with arcadedb==26.11.1.post2. Both packages printed exactly the output on the page, the error message included. The page now says that, and the old-name remark is gone.
  • Facets and COLUMNAR index: I added an install hint for the pre-release wheels to the older-engine section of facets.adoc, and a pointer to it in columnar-index.adoc. I checked it with 26.12.1.dev2 of both packages: the COLUMNAR index and a FACETS clause run, a plain uv add resolves to 26.11.1.post2, and --prerelease allow resolves to 26.12.1.dev2.
  • Concurrency probes: the probe scripts are not in the repository and each run takes minutes to hours, so I added the caveat the issue allows: the probes ran on older builds and were not run again on 26.11.1.post2.
  • ci.adoc: the two lines with docs/** and *.adoc now wrap the globs as passthrough in code spans, the way the native-paths bullet is. The local Antora build has no warning, and the page renders them as code.

The code and config items of #365 (the python3 hook, the pyproject.toml comment, the version examples) are in #374.

Still open in #365 after both pull requests: the figures measured on 26.11.1.dev0 (which-package.adoc, vectors.adoc, installation.adoc) need a re-measurement, the concurrency probes can be re-run when their scripts are in the repository, and shortening the pre-fix measurement in bulk-loads.adoc is an editorial choice that I left alone because it removes measured numbers.

🤖 Generated with Claude Code

…ncurrency caveat, ci.adoc bold (refs #365)

quickstart.adoc: its three scripts ran on Python 3.12 against arcadedb-jvm and arcadedb 26.11.1.post2 (extracted from the page and run with uv); both packages printed exactly the output on the page, so the sentence now says that and the old-name remark is gone.

facets.adoc and columnar-index.adoc: an install hint for the pre-release wheels (checked with 26.12.1.dev2 of both packages: the COLUMNAR index and a FACETS clause run; a plain uv add installs 26.11.1.post2, --prerelease allow installs 26.12.1.dev2).

concurrency.adoc: a caveat that the probes ran on older builds and were not run again on 26.11.1.post2.

ci.adoc: `docs/**`, `*.adoc` and `LICENSE*` are wrapped as passthrough in code spans, as the native-paths bullet is.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@tae898
tae898 merged commit 9e3483e into main Nov 12, 2026
6 checks passed
@tae898
tae898 deleted the docs/365-quickstart-facets-ci branch November 12, 2026 00:42
@github-actions github-actions Bot added this to the 26.12.1 milestone Nov 12, 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