bindings docs: development and testing pages match the tests, scripts, and workflows (#62) - #63

…, and workflows (sweep 2026-10-02)

Asserts corrected: testing pages no longer claim asserts the tests do not
make (to_json_list batches, to_dataframe path, first() amount, parallel
flush workers, exporter header and LINK, RDF import, Arrow bools, async
getters, vectorNeighbors without FROM, schema reopen and idempotence,
naive datetimes, numpy query read-back, "persisted" writes, second-pass
timing, HASH skips, jar provenance, server-patterns timings, overview
geo and large-result bullets, cross-model atomicity arms).

Build instructions: JAR_LIB_DIR path points at the full assembly's lib;
JAR_LIB_DIR is build.sh's third argument (an env var is ignored) and
Linux-only; headless assembly caveat; Quick Starts say to build a cp312
wheel first and run from the root or bindings/python; native build
requirements and the in-place pyproject.toml rewrite; the version suffix
comes from the tag through BUILD_VERSION; formatting through pre-commit.

Holes filled: every "See the source" placeholder replaced with what the
test asserts; docs-example test coverage; Skips section; writing a test
for this suite (fixtures, guards, one JVM, importorskip, hang
diagnostics, Bandit); fixed ports; Docker stages; CI test run; examples
workflow behaviour; architecture exports, JVM defaults, ResultSet close,
type table, jar exclusions; bridge internals; dev-environment
troubleshooting and log locations.

Stale retired: per-page test counts and positional test references;
dated "until 2026-..." narrative; unsourced timings; the wrong bash
counter advice and the Common Issues history in build-architecture.md;
RESTORE and schema-batching history; GraphML/GraphSON listed as export
formats.

CI/release docs: Example 21 runs at reduced scale; publish job
continue-on-error and docs deploy not waiting for the release; artifact
names and retention; import-skip gate scope; examples Bandit command;
upstream PR branch scope and pre-commit command; unpinned docs deploy;
log location.

Comment-only code fixes: graph_export marker registered in the root
pyproject.toml; build.sh header path, usage text for native builds, and
next-step hints; test_vector_delta_visibility.py docstring (COST is not
asserted); test_vector.py and test_vector_sql.py comments that
contradicted or overstated their asserts; stale Example 21 comment in
test-python-examples.yml; test-python-bindings.yml header about
sync-upstream.sh.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WWcDr7TwvcfMsQkeYQVHZr