[imbajin]

Before → After

Before: Standalone setup contracts, shard-bound requirements, and community-native Topling profile preparation were not documented consistently across both languages.

After:

• Rebased onto origin/master (post-docs: unify client navi struct and streamline GQL docs (EN/CN) #557), cleanly incorporating PR docs: unify client navi struct and streamline GQL docs (EN/CN) #557's OINK components (Steps, Tabs, Cards, Alerts) and traverser batch APIs alongside PR docs: clarify standalone deployment contracts #559's standalone deployment contracts.
• Clarified standalone deployment contracts: Server 1.8 RocksDB artifact selection vs HStore/Helm single-node topologies, named volume data persistence (rocksdb-data), configuration write permissions, and Java 17/auth initialization.
• Traversal sources and bindings: Standalone Server 1.8 uses GraphSpace-scoped traversal source __g_DEFAULT-hugegraph and graph binding DEFAULT-hugegraph.
• Shard scan bounds and pagination: Documented required start and end bounds (explicit empty values for open bounds, HTTP 400 when missing) and explicit page pagination semantics for vertex and edge scans.
• ToplingDB version boundary (addresses reviewer feedback from @bitflicker64): Explicitly distinguished that the community-native SkipList/BlockBasedTable profile in conf/toplingdb.yaml applies to Server 1.8.0+ (apache/hugegraph#3447 / master), whereas existing/prior builds (such as 1.7.0) ship with cspp memtable and DispatcherTable.

Source: hugegraph#60
Paired implementation source: apache/hugegraph#3447

Validation boundary & results

• Hugo Strict Build: ./scripts/hugo.sh build renders all 668 pages (EN: 335, CN: 333) with 0 errors.
• Link Integrity: bash dist/validate-links.sh passes with 0 broken links.
• Unit Tests: python3 -m unittest discover -s scripts/ passes all 290 tests (1 skipped).
• Git Diff Check: git diff --check clean.

Visual overview

Before → After: missing shard bounds return HTTP 400 while explicit empty bounds remain valid; Topling preparation adds actual-profile native import after the isolated EasyMigrate probe, before installing local runtime files. Profile import does not open production databases or convert existing SSTs, and it does not establish deployment or data-compatibility acceptance.

[bitflicker64]

Blocking: yes. Summary: The standalone deployment, Gremlin binding and shard-scan text matches apache/hugegraph master 8e327b8 or is scoped to the fixes in apache/hugegraph#3447, but the Topling default-profile paragraph describes a profile that no build ships until apache/hugegraph#3447 merges.

[bitflicker64]

Important: master's Server conf/toplingdb.yaml still selects the cspp memtable and a DispatcherTable over CSPPMemTabTable, and the SkipList/BlockBasedTable profile exists only in open apache/hugegraph#3447, so a user with a community Topling JNI who trusts this paragraph on any current build fails at Server initialization. Merge this after apache/hugegraph#3447, or name the Server version that ships that profile here and in the cn mirror.

[imbajin]

Thanks @bitflicker64 for the careful review!

This PR has been rebased onto current origin/master (commit 19e2573f1, which merged PR #557) and updated:

1. ToplingDB Version Boundary Addressed:

   • In both English and Chinese (content/{en,cn}/docs/guides/dev-test/toplingdb.md), explicitly distinguished the version boundary:
     • Clarified that the community-native profile in conf/toplingdb.yaml (using standard SkipList memtables and BlockBasedTable files without requiring cspp, CSPPMemTabTable, or DispatcherTable plugins) applies to Server 1.8.0+ / master (apache/hugegraph#3447).
     • Explicitly noted that current and prior release builds (e.g. 1.7.0) ship conf/toplingdb.yaml configured with cspp memtable and DispatcherTable, and reminded users on older versions using community JNI without CSPP plugins to adjust conf/toplingdb.yaml accordingly to prevent initialization errors.

2. Rebase & Modern OINK Typography Preserved:

   • Cleanly integrated PR docs: clarify standalone deployment contracts #559's standalone deployment contracts, container recipes, and troubleshooting matrices into content/{en,cn}/docs/quickstart/hugegraph/hugegraph-server.md while preserving all modern OINK components (Tabs {tab="..."}, Cards {.td-cards-list}, and Alerts) introduced by PR docs: unify client navi struct and streamline GQL docs (EN/CN) #557.
   • Preserved shard scan bound validations in content/{en,cn}/docs/clients/restful-api/traverser.md alongside the newly added Same Neighbors batch API.
   • Aligned Gremlin traversal source alias clarifications (__g_DEFAULT-hugegraph) in both languages.
   • Wrapped prose cleanly to adhere to project constraints.

3. Validation Passed:

   • python3 -m unittest discover -s scripts/: 290 tests pass (1 skipped).
   • ./scripts/hugo.sh build: Renders 668 pages (EN: 335, CN: 333) with 0 errors.
   • bash dist/validate-links.sh: 0 broken links.
   • git diff --check: Clean.

[bitflicker64]

Blocking: yes. Summary: The standalone deployment, Gremlin binding, shard-scan and HStore-reuse text matches apache/hugegraph master 8e327b8 and 1.7.0, or is scoped to fixes in open apache/hugegraph#3447. The Topling version note added since the last review misstates what master and 1.7.0 ship.

[bitflicker64]

Important: master's conf/toplingdb.yaml still selects the cspp memtable and DispatcherTable, and the 1.7.0 release ships no Topling profile or prepare-topling.sh, so a community-JNI user on master who trusts this paragraph hits the initialization failure it warns about. Scope the SkipList profile to builds containing the compatibility-profile fix, as line 128 does, and drop the 1.7.0 sentence here and in the cn mirror.