[tae898]

What

Based on docs/antora-component (#23, still open); merge after #23, or retarget to main once it lands. Scope rule applied: these docs cover only what is specific to the Python bindings and link the main ArcadeDB docs for everything else.

• New page docs/modules/ROOT/pages/packages.adoc, "Which package for which mode". The embedded packages (arcadedb-embedded JVM build, arcadedb-embedded-native preview, and the names they move to in mid-November: arcadedb, arcadedb-native, arcadedb-jvm) with the rule of thumb: short-lived and footprint-sensitive processes use native, long-lived processes with heavy repeated scans or big loads use the JVM build, several processes or services sharing one database use the server. One line each for arcadedb-driver and arcadedb-driver-grpc with xrefs to the main docs' Python HTTP and gRPC driver pages, and one line for the unrelated community arcadedb-python (stevereiner), which shares this repository's name. The page links the index sections on embedded vs HTTP and JVM vs native instead of repeating them. PyPI facts checked on 2026-10-24.
• No "Coming from Postgres or SQLite" page: the main docs already cover it. The quickstart gets one sentence (ArcadeDB SQL is its own dialect without JOINs) linking arcadedb::reference/sql/sql-introduction.adoc#no-joins, and the how-to gets one Python-specific NOTE (SQLAlchemy, other ORMs and tools that generate JOIN queries do not work with db.query/db.command).
• Scope trims of docs: Antora component arcadedb-python with the first slice of pages #23's pages, kept here so docs: Antora component arcadedb-python with the first slice of pages #23 stays as reviewed: the how-to's "Parameters" lost the SQL-injection and statement-cache explanation, "SQLScript" and "openCypher" now link the main docs' SQLScript and openCypher references, and the index gets an anchor (jvm-vs-native) to link to. The quickstart, installation and index pages are otherwise Python-specific and unchanged.
• docs/antora.yml gets short-pkg-name, short-native-pkg-name, jvm-pkg-name, driver-pkg-name, grpc-driver-pkg-name, community-driver-pkg-name and community-repo-url, so the November renames are a one-place edit. nav.adoc lists the packages page.

Checked locally

Antora build with the main ArcadeDB docs (arcadedb-docs, branch docs/arcadedb-python-component) and this branch as sources: exit code 0, no warnings from this component, and the xrefs resolve to reference/sql/sql-introduction.html#no-joins, the Python HTTP and gRPC driver pages, the SQLScript and openCypher references. Only prose changed in the script pages, so their outputs (run against arcadedb-embedded 26.10.2.post1 earlier) are untouched.

🤖 Generated with Claude Code