[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): The community-native SkipList/BlockBasedTable profile and preparation validation require a build containing apache/hugegraph#3447. Earlier development builds may require CSPP plugins; Server 1.7.0 does not include that profile or prepare-topling.sh. The documentation and implementation should be merged in that order.

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.

[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.

[imbajin]

Review follow-up at 2b41f3a8fa379120ac725773b3a855ff30d45159: the English and Chinese guides now scope the community-compatible Topling profile and preparation validation to builds containing apache/hugegraph#3447. The 1.7.0 release does not include the profile or preparation script. The linked implementation needs to merge before these instructions are used.

Validation on this revision: python3 -m unittest discover -s scripts/ passed 290 tests (1 skipped), ./scripts/hugo.sh build rendered 668 pages, and git diff --check passed. The new GitHub CI run is pending. Full link validation was not completed on this revision.

[bitflicker64]

Blocking: no. Score: 9/10. Summary: The standalone deployment, Gremlin binding and shard-scan text matches apache/hugegraph master 0abd931 and 1.7.0, and the Topling profile, preparation and scan-validation behaviour is scoped to builds containing apache/hugegraph#3447, which resolves both earlier Topling findings.

[bitflicker64]

Blocking: no. Score: 9/10. Summary: The standalone deployment, Gremlin binding and shard-scan text matches apache/hugegraph master 8828d82 and 1.7.0, and the Topling profile, preparation and scan-validation behaviour stays scoped to builds containing apache/hugegraph#3447 (head a6d72a5). The changes since the last approval scope the edge-scan rule to that fix, replace the relative-path normalization claim with an absolute-path requirement, and split paragraphs.