Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

---

**Quick Navigation:** [Architecture](#architecture) • [Quick Start](#quick-start) • [Module Map](#module-map) • [Ecosystem](#ecosystem) • [For Contributors](#for-contributors) • [Community](#community)
**Quick Navigation:** [Architecture](#architecture) • [Quick Start](#quick-start) • [Module Map](#module-map) • [Ecosystem](#ecosystem) • [For Contributors](#contributing) • [Community](#community)

---

Expand Down Expand Up @@ -190,7 +190,7 @@ The launch scripts reject Java versions older than 17. That minimum-version
check does not qualify later Java releases; use Java 17 unless another release
is explicitly listed as supported.

For this upgrade, read the [TinkerPop 3.8.1 migration guide](docs/upgrade-tinkerpop-3.8.md)
Read the [Server runtime guide](docs/server-runtime.md#runtime-and-client-configuration)
for client configuration and query compatibility checks.

### Option 1: Docker (Fastest)
Expand Down
2 changes: 1 addition & 1 deletion docs/BUILDING.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ bytecode for downstream compatibility. Their build and tests still run on
Java 17; this library bytecode target does not lower HugeGraph's runtime
requirement.

See the [TinkerPop 3.8.1 migration guide](upgrade-tinkerpop-3.8.md) for the
See the [Server runtime guide](server-runtime.md#runtime-and-client-configuration) for the
upgraded runtime, client configuration and compatibility checks.

To build without executing tests: `mvn clean package -Dmaven.test.skip=true`
Expand Down
32 changes: 6 additions & 26 deletions docs/ci.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,13 +52,11 @@ remain. This changes CI preparation, not product support or backend deprecation
TinkerPop suites run only when the source, target or push/manual branch starts with
`release-`, `test-` or `tinkerpop-`. PRs run no TP suites when neither source nor target
branch matches these prefixes, including `upgrade/1.8.0` targeting `master`.
Historical task-branch exceptions and the temporary TP skip are removed. Executed TP suites
still require non-empty reports with actual executed tests.
Executed TP suites require non-empty reports with actual executed tests.

PD, Store and Commons have total job budgets of 30, 45 and 20 minutes, respectively,
based on six recent successful master runs across Org and ASF. Cluster has 120 minutes,
preserving its two existing 45-minute test windows and allowing build/diagnostic time.
Server and HStore budgets remain unchanged pending complete TP execution history.
PD, Store and Commons have total job budgets of 30, 45 and 20 minutes, respectively.
Cluster has 120 minutes for its two 45-minute test windows and build/diagnostic time.
Server and HStore budgets are defined in their workflow job settings.

## Documentation and freshness

Expand All @@ -80,30 +78,12 @@ Plans and actual results are diagnostics, not execution credentials for later ru

`.asf.yaml` requests only `check-license` and `Server memory tests`. Keep these required check
names stable. The Memory workflow runs real unit, core and API tests on the project runtime
and reports their results through `Server memory tests`; the former Java 11 placeholder is
removed. The former `build-commons (11)` placeholder is also removed; real Commons tests
remain advisory and install only the Commons reactor and its upstream modules.
and reports their results through `Server memory tests`. Commons tests remain advisory
and install only the Commons reactor and its upstream modules.
`affected-module-tests` and CodeQL remain advisory. Verify live branch protection
when changing required checks; do not forge a successful result or leave retired contexts required.

Only failed push runs of License Checker and Server Memory CI automatically retry, at most
twice. The trusted checker verifies the workflow path, attempt, repository and unchanged branch
head before and after the delay. PRs and advisory workflows never automatically retry.
Use a manual rerun when appropriate; a rerun retains its original commit and event.

## Follow-up work

These changes need separate CI policy decisions or broader validation:

- Split compatibility selection by backend, native code, JDK and shared startup/core impact,
retaining Server/PD/Store/Cluster coverage and periodic complete compatibility checks.
- Narrow PD/Store/HStore/Cluster reactors only after verifying every required distribution;
evaluate sharing artifacts between jobs separately.
- Choose an explicit RocksDB comparison baseline for the first push to a new release-/test-
branch, where `before` is all zeros. Do not silently compare a commit with itself.
- Revisit RISC-V `continue-on-error`; it remains advisory and is not a required check.
- Consider merging runtime resolution into planning and extracting long diagnostic scripts.
- Replace broad push failure reruns with bounded retries at known transient operations;
preserve workflow, repository, attempt and unchanged-head checks.
- Set total timeouts only where complete test history supports a budget, including diagnostics.
Do not size HStore or Server TP budgets from runs that skipped TP suites.
96 changes: 0 additions & 96 deletions docs/cypher-compatibility.md

This file was deleted.

41 changes: 0 additions & 41 deletions docs/query-semantics.md

This file was deleted.

Loading
Loading