Skip to content

docs(development): clarify migrations and repair release checks - #568

Open
imbajin wants to merge 4 commits into
apache:masterfrom
hugegraph:docs/developer-upgrade-checks-20261115
Open

imbajin wants to merge 4 commits into
apache:masterfrom
hugegraph:docs/developer-upgrade-checks-20261115

Conversation

@imbajin

@imbajin imbajin commented Nov 16, 2026

Copy link
Copy Markdown
Member

Purpose of the PR

Repair release-verification examples that could execute prose as shell commands or hide an earlier checksum failure, and clarify the current migration workflow.

  • Stop checksum validation at the first failure, retain full-fingerprint signature checks, and remove stale imported-key logs.
  • Correct runtime prerequisites and separate commands from illustrative output.
  • Explain OLAP property cleanup/write coordination and make the shared-foundation and Gremlin migration guidance easier to scan.

Validation: all Bash examples passed syntax checks. Checksum trials covered success, an early failure followed by a valid package, a missing sidecar and no archives. Source-contract review, strict artifact checks and independent cross-review passed. Public routes and legacy heading links are preserved.

@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 checksum subshell loop, Maven RAT rename, Java 17/11 baselines, TinkerPop 3.8.1 and Groovy 4.0.25 versions, and the HStore OLAP clear/remove, bounded-batch and no-writer-coordination text match pom.xml, computer/pom.xml, HstoreStore.deleteOlapData and the OLAP schema jobs on master. One time-anchored JDK comment, in both languages.

@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 subshell checksum loop stops on the first failed or missing sidecar, the JDK 17/11, Maven RAT, TinkerPop 3.8.1 and Groovy 4.0.25 text matches the Server, Toolchain and Computer poms, and the HStore OLAP clear/remove, bounded-batch and no-writer-coordination rows match HstoreStore.deleteOlapData and the OLAP schema jobs; the earlier time-anchored Computer JDK comment is fixed in both languages.

@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 checksum loop, gpg steps, JDK 17/11, TinkerPop 3.8.1, Groovy 4.0.25 and HStore OLAP clear/remove text match the code and poms; one inserted blockquote break splits a sentence into two paragraphs in both languages.

@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: 8.5/10 · Confidence: medium

Blocking: no

Summary

No new issues found. The existing minor formatting issue splits the serializer explanation across paragraphs in both languages.

Evidence

Reviewed bilingual diff and HStore cleanup implementation; bounded batch commits and lack of writer coordination match the guidance. The earlier JDK wording was fixed.

Validation notes

No live release verification or distributed HStore integration test was run.

@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 subshell checksum loop stops on the first failed or missing sidecar in bash and zsh, the JDK 17/11, Maven RAT, TinkerPop 3.8.1 and HStore OLAP clear/remove, bounded-batch and no-writer-coordination text match the Server and Computer poms, HstoreStore.deleteOlapData and the OLAP schema jobs on master, and both earlier wording comments are fixed in both languages.

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