Skip to content

docs(computing): correct algorithm and snapshot workflows - #575

Open
imbajin wants to merge 8 commits into
apache:masterfrom
hugegraph:docs/computing-guide-refresh-20261115
Open

imbajin wants to merge 8 commits into
apache:masterfrom
hugegraph:docs/computing-guide-refresh-20261115

Conversation

@imbajin

@imbajin imbajin commented Nov 16, 2026

Copy link
Copy Markdown
Member

Purpose of the PR

Make the bilingual Vermeer and Computer instructions match the engines users run. Several old examples used misleading sampling or request forms, and the Computer snapshot example described a recovery capability it does not provide.

  • Document result-property type migration, minimum step budgets, full versus sampled centrality, and coordinated version upgrades.
  • Replace repeated request wrappers with valid parameter examples and retain old heading links.
  • Provide complete MinIO input-snapshot write/read steps and explain what state those snapshots retain.

Validation: strict artifact checks, JSON checks and desktop/mobile reader/gallery checks passed. An isolated four-vertex native graph verified Closeness, Betweenness, Triangle Count, Clustering and boolean Cycle Detection; insufficient Triangle/Clustering step budgets were rejected. Existing writeback-schema migration and production-scale behavior were not exercised.

Based on Helm #68, which owns the shared screenshots. This PR contains the computing guides and their concise verification scope.

@bitflicker64 bitflicker64 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blocking: no. Summary: The Vermeer and Computer claims match hugegraph-computer and hugegraph-toolchain master, and every in-page link, including the preserved Chinese anchors, resolves in a Hugo render. One evidence entry point references a path that exists only on the verifying machine; the stacked Helm commits are reviewed on #574.

Comment thread scripts/vermeer-refresh-evidence.md Resolved

@bitflicker64 bitflicker64 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blocking: no. Summary: The Vermeer and Computer changes match hugegraph-computer and hugegraph-toolchain master, and f6b10e57 drops the machine-local evidence path raised earlier. One comment covers Helm text stacked from #574 that lacks its follow-up fixes.

@imbajin
imbajin force-pushed the docs/computing-guide-refresh-20261115 branch from f6b10e5 to 344ef36 Compare November 19, 2026 11:58

@bitflicker64 bitflicker64 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blocking: no. Summary: The Vermeer step budgets, result types, centrality sampling, version check and Computer MinIO snapshot workflow match hugegraph-computer and hugegraph-toolchain master, and the rebase onto #574 resolves both earlier comments. One link in the stacked Chinese Helm text points to a missing anchor.

Pengzna
Pengzna previously approved these changes Nov 21, 2026
@imbajin
imbajin force-pushed the docs/computing-guide-refresh-20261115 branch from 344ef36 to bb10f5a Compare November 21, 2026 13:27

@bitflicker64 bitflicker64 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blocking: no. Score: 9/10. Summary: The Vermeer step budgets, result types, task fields, paging, Hubble catalog and the Computer MinIO snapshot workflow match hugegraph-computer and hugegraph-toolchain master, both languages render with every link and preserved anchor resolving, and the three earlier comments are resolved at this head.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants