contrueCT opened a new pull request, #541:
URL: https://github.com/apache/hugegraph-doc/pull/541
## What does this PR do?
This PR adds comprehensive documentation for the upcoming HugeGraph 1.8.0
release regarding **TinkerPop 3.8.1 upgrade compatibility and Gremlin
migration**, aligning with Java 17 and Groovy 4.0.25 runtime requirements.
### Key Changes
1. **Migration Guides (Bilingual)**:
- Added `content/cn/docs/guides/gremlin-migration-3.8.md` and
`content/en/docs/guides/gremlin-migration-3.8.md`.
- Highlighted the **Top 6 high-frequency syntax breaking changes** with
comparative code examples:
- Removal of `has(key, traversal)` overload (avoids silent empty
results in Groovy).
- Removal of `store()` and scoped `aggregate()` steps.
- Parameterless `none()` renamed to `discard()`.
- Stricter `by()` behavior on missing properties (`order`, `project`,
`path` drops) and `coalesce` patterns.
- `choose()` branch semantics alignment.
- Datetime return types (`OffsetDateTime`) and `dateDiff()` unit change
(seconds to milliseconds).
- Documented server serializer migration (`gremlin.util.ser.*`) and
HugeGraph Client 1.5.0 backward-compatibility support.
- Categorized 70+ secondary edge cases and GLV client variations into
quick-reference appendices.
2. **Gremlin Language Reference**:
- Updated `hugegraph-gremlin.md` (CN & EN) features table
(`supportsUniformListValues=false`) and step tables (added `discard`,
`datetime`, `mergeV`, `mergeE`, removed `store`).
3. **Quickstart & Introduction Scope Refinements**:
- Refined 1.7 vs master/1.8 scope warnings in
`quickstart/hugegraph-server.md` and linked to the migration guide.
- Polished storage backend support statements in `introduction/_index.md`.
4. **1.8.0 Release Notes Draft**:
- Prepared initial 1.8.0 release notes skeleton summarizing Gremlin and
runtime breaking changes.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
