Skip to content

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

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

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

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

Pengzna
Pengzna previously approved these changes Nov 21, 2026
…rty-filter restrictions and update PD diagnostics label

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