Skip to content

docs(hubble): refresh workflows, upgrade guidance and screenshots - #573

Open
imbajin wants to merge 4 commits into
apache:masterfrom
hugegraph:docs/hubble-refresh-20261115
Open

imbajin wants to merge 4 commits into
apache:masterfrom
hugegraph:docs/hubble-refresh-20261115

Conversation

@imbajin

@imbajin imbajin commented Nov 16, 2026

Copy link
Copy Markdown
Member

Purpose of the PR

Bring the English and Chinese Hubble guides and screenshots into line with the current application, so users can deploy, import, query and recover from common failures without relying on old UI behavior.

  • Refresh 28 real screenshots and clarify query limits, import counters, task identities, permissions, quotas and Text2GQL.
  • Explain H2 metadata upgrades and the Vermeer cleanup required before deleting source graphs or spaces.
  • Use native OINK Gallery and Duo View, retain old links, and split dense instructions into readable steps and paragraphs.

Validation: source checks, strict build, independent artifact/link checks and desktop/mobile interaction checks passed. Real standalone import/count and authenticated minimal Helm workflows are recorded in the screenshot fixtures. Original-image viewing, keyboard focus and mobile layout were checked.

The theme is already OINK 1.5.1; this PR changes content and reuses its public components.

@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 query-limit, Text2GQL, session, Clone Schema, quota, Vermeer and metadata claims match hugegraph-toolchain and hugegraph master, and all images, fixture digests and anchors resolve. Three added sentences anchor behaviour to a point in time or omit a version requirement, and the audit note points at an uncommitted artifact.

Comment thread scripts/hubble-refresh-audit.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 query-limit, Text2GQL, session, Clone Schema, quota, Vermeer and H2 metadata claims match hugegraph-toolchain and hugegraph master, the four comments from the earlier head are fixed, and all images, digests and anchors resolve. Two added passages name UI labels that Hubble does not show.

@imbajin imbajin left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Score: 6.5/10 · Confidence: high

Blocking: yes

Summary

The new browser test leaves the PR artifact, and the linked Vermeer guide understates the supported algorithm catalog. Existing UI label corrections also remain applicable.

Evidence

Reviewed the test origin and canonical URL configuration, guide text, Hubble adapter allowlist and frontend translations.

Validation notes

Source inspection only; browser tests and a live Hubble/Vermeer deployment were not run.

Comment thread tests/e2e/duo-view.spec.js 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: yes. Summary: The query-limit, H2 metadata, Text2GQL, session, quota, Clone Schema and UI label claims match hugegraph-toolchain and hugegraph master, and the eight earlier comments are fixed at this head. The expanded Vermeer catalog names fast_louvain, which Hubble rejects, instead of louvain_weighted.

| `pagerank.diff_threshold` | Convergence threshold | `0.00001` |

Current Hubble accepts `pagerank`, `wcc`, `lpa`, `degree`, `closeness_centrality`, `betweenness_centrality`, `triangle_count`, `kcore`, and `sssp`.
The Hubble direct adapter accepts 19 algorithms: `pagerank`, `ppr`, `wcc`, `scc`, `lpa`, `slpa`, `degree`, `closeness_centrality`, `betweenness_centrality`, `triangle_count`, `kcore`, `sssp`, `clustering_coefficient`, `depth`, `cycle_detection`, `louvain`, `fast_louvain`, `kout`, and `jaccard`.

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.

Important: DirectVermeerService.compute does not accept fast_louvain, so a request with it fails with Unsupported Vermeer algorithm, and the accepted louvain_weighted goes unlisted. Replace fast_louvain with louvain_weighted here and at line 463 of the CN guide.

Degree Centrality, Closeness Centrality, Betweenness Centrality, Triangle Count, K-Core, and Single-Source Shortest Path (SSSP).
- **Algorithm catalog**: The direct adapter supports 19 algorithms, including PageRank/PPR, WCC/SCC, LPA/SLPA,
centrality, Triangle Count, K-Core, SSSP, Clustering Coefficient, Depth, Cycle Detection, Louvain variants, K-out and Jaccard.
Select the form for the current engine; parameters and property-filter restrictions are listed in the Vermeer guide.

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: the Vermeer guide lists no property-filter restrictions, so this pointer leads nowhere, here and at CN line 335. Add to section 2.4 of the Vermeer guide, in both languages, that Hubble rejects filter.vertex_expr / filter.edge_expr for cycle_detection and louvain.edge_weight_property for louvain_weighted, or drop the pointer.

returned by PD, and ensure targets are in `operations.store.allowed_targets`. A partially available overview indicates metrics collection was blocked for
specific sources, not that graph APIs are down.

When `pd.server` names a Service or proxy that cannot identify one member, its process metrics remain a **configured endpoint sample**.

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: the diagnostics label is Configured PD endpoint sample (CN 配置的 PD 端点样本), so readers will not find configured endpoint sample here or 【配置端点采样】 at CN line 245. Use the hubble-fe i18n labels in both files.

@imbajin imbajin left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Score: 7.0/10 · Confidence: high

Blocking: yes

Summary

The catalog names an unsupported algorithm and omits a supported one; the linked filter restrictions and diagnostics label also need correction. No additional actionable findings were identified.

Evidence

Compared the bilingual diff with DirectVermeerService's allowlist and filter validation and with frontend translations.

Validation notes

Source review only; browser tests and live Hubble/Vermeer workflows were not independently run.

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