[tae898]

Docs cleanup before the first pre-release, built on main. The docs set was already in good shape (11 pages, all in the nav, no orphans, the Python/embedded rule held: the HTTP driver, SQL, openCypher and transactions link to the main ArcadeDB docs by xref). This PR fixes what was left.

What changes

• Which package is unmissable. The start page table now has an Install column and says "Not sure which one? Take arcadedb". The install page and the quickstart say the same. The README intro no longer describes arcadedb as "a sibling" of arcadedb-jvm; it states the two packages side by side.
• Placeholder trap. PyPI shows arcadedb and arcadedb-jvm at 0.0.1 only. Both placeholders install the old arcadedb-embedded (checked with the PyPI JSON API). A plain pip install arcadedb therefore does not give the new package, even after 26.11.1.dev0 exists, because pip skips pre-releases. The transition notes (README, start page, install page, Which package?, quickstart) now say so, next to the --pre advice. They carry the existing REMOVE WHEN marker.
• arcadedb-native is no longer documented. The name is reserved with no files and no publisher (MIGRATION decision, 2026-10-25). The "third name is planned" paragraph of Which package? and the README row are removed.
• Old names say what really happens (humemai PR 512, decided 2026-10-25): the last arcadedb-embedded release is a shim that installs arcadedb, the native build, so the runtime changes for those users and arcadedb-jvm is the way to keep the JVM; arcadedb-embedded-native is archived on PyPI, no shim. Changed in the Which package? table, the install-page note, the README and the PyPI description of arcadedb (native/wheel/README.md).
• Numbers without a measured source removed. The comparison table said native starts in "milliseconds" and the JVM in "about one second or more"; no measurement backs either. Both cells are qualitative now.
• Quickstart no longer claims its output came from "the published arcadedb-jvm wheel" (no such wheel exists yet). It says the JVM build 26.10.2.post1 (formerly arcadedb-embedded).
• Duplicated content. The start page's "Native build or JVM build" section repeated the Which package? table; it is now two sentences and a link.

Overlap with the sibling PRs

Checked with trial merges of main + this branch with #83 and with #84, separately and together: no conflicts.

• native: build the Linux wheels in manylinux_2_28, test Python 3.15, document platforms #83 (platforms, Python 3.15, glibc) owns the Requirements sections, the platform table and the Python versions / Platforms rows. I did not touch them, including the start page's own Requirements bullets, which duplicate the install page; fold them into one after native: build the Linux wheels in manylinux_2_28, test Python 3.15, document platforms #83 lands.
• docs: limits of the native build, garbage collector row, migration steps #84 (native limits, GC row, migration steps) owns the Garbage collector row and the [[migrate]] section. I left one sentence in place on purpose, because editing it conflicts with docs: limits of the native build, garbage collector row, migration steps #84: after docs: limits of the native build, garbage collector row, migration steps #84 merges, the sentence "The old packages will get a deprecation shim that points to the new names." under [[migrate]] should go. The Old names table above it now says it precisely: arcadedb-embedded gets a shim that installs arcadedb, and arcadedb-embedded-native is archived with no shim. docs: limits of the native build, garbage collector row, migration steps #84's step 2 ("pip install arcadedb-jvm if you used arcadedb-embedded") is right for people who want the same build; the shim is for those who do not act.

Left as is, scheduled

• pyproject.toml Documentation, examples/README.md (3 links), tests/README.md (2 links) and the README "Documentation" bullet point to docs.humem.ai, which answers 200 and is the only place for the guide and API reference today. They move when https://docs.arcadedb.com/arcadedb-python/ is live (it is 404 now; arcadedb-docs#505 is open), per the migration plan item A7.
• docs/superpowers/ holds the plans of the repository move. It is not published, and scripts/check_no_embedded_name.py allows it on purpose.
• how-to/concurrency.adoc and how-to/bulk-loads.adoc keep their numbers: each states its probe date and setup, or the ab.py --noise method.

Checks

• npx -y [email protected] --failure-level WARN -o /dev/null on index, installation, quickstart and which-package: clean.
• python3 scripts/check_no_embedded_name.py: clean.

🤖 Generated with Claude Code