Skip to content

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

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

imbajin wants to merge 7 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.


在 `values-cluster.yaml`(`store.updateStrategy.type=OnDelete`)预设下,`helm upgrade` 不会自动重建 Store Pod。
即使镜像名称匹配,旧 Pod 也并未以 `Always` 策略重新挂载 PVC。
请按[受控滚动升级流程](./hugegraph-helm-operations.md#6-安全逐个滚动更新-store-镜像)逐个删除并重建 Store Pod。

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.

Minor: #6-安全逐个滚动更新-store-镜像 matches no id on the rendered operations page, whose heading sets {#6-rolling-store-images-safely}, so the link opens the page top instead of the rollout procedure. Use #6-rolling-store-images-safely, as the English page does, in #574 and rebase.

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.

2 participants