bitflicker64 commented on code in PR #499:
URL: https://github.com/apache/hugegraph-doc/pull/499#discussion_r4433583135
##########
content/en/docs/language/_index.md:
##########
@@ -1,7 +1,41 @@
---
-title: "Query Languages"
-linkTitle: "Query Languages"
+title: "Graph Query Languages"
+linkTitle: "Graph Query Languages"
weight: 7
---
-HugeGraph supports Gremlin and Cypher. This section mainly covers Gremlin; see
the [Cypher API](/docs/clients/restful-api/cypher/) for the Cypher HTTP
interface.
+HugeGraph supports two mainstream graph query languages: **Gremlin**
(imperative traversal language) and **Cypher** (declarative pattern matching
language).
+
+- **Gremlin**: The core graph traversal language of Apache TinkerPop, offering
rich traversal primitives and fine control over complex topological paths.
+- **Cypher**: The declarative query language standardized by openCypher,
featuring intuitive SQL-like patterns (`MATCH ... WHERE ... RETURN`) for Neo4j
parity.
+
+## Language Guides & References
+
+- [HugeGraph-Gremlin](/docs/language/hugegraph-gremlin/)
+
+ Gremlin traversal fundamentals, CRUD query examples, TinkerPop feature
support, and 1.8 upgrade changes.
+- [HugeGraph Cypher](/docs/language/hugegraph-cypher/)
+
+ Cypher language support via cypher-for-gremlin, read/write statement
examples, execution mechanics, and constraints.
+- [Cypher Compatibility](/docs/language/cypher-compatibility/)
+
+ Coverage matrix for Cypher clauses and functions, known behavior
differences, and workarounds for unsupported features.
Review Comment:
Minor: this card promises a coverage matrix for Cypher clauses and functions
with workarounds, but `cypher-compatibility.md` is a request-contract
verification record with no such matrix, and the line 25 card promises
`multiple labels`, which `migrate-from-neo4j.md` never covers. Describe what
the two pages contain, and mirror the fix in CN `_index.md` lines 22 and 25.
##########
scripts/versioning.py:
##########
@@ -134,36 +134,36 @@
DOCS_NAV_EXPECTED_STATS = {
"latest": {
"groups": 5,
- "pages": 96,
+ "pages": 99,
"removed": 4,
"scopedLinks": 0,
- "treeSha256":
"8b2b1f270a27b909b673a30d186c46a6a0feccab4c4a980d9b8127686346be2b",
+ "treeSha256":
"228c59c99880695982722c1cd4fcb975afe38d28a6464d4ecb3c43f446d394ab",
},
"1.7": {
"groups": 5,
"pages": 85,
- "removed": 9,
+ "removed": 12,
"scopedLinks": 10,
"treeSha256":
"c87538b82b0e3506eef59417411686ddc188e0f33d0e3a1cda687de8d6f88747",
},
"1.5": {
"groups": 5,
"pages": 77,
- "removed": 17,
+ "removed": 20,
"scopedLinks": 10,
"treeSha256":
"ac29ab8f0e7020496a3a1afe480687043d751e32c93ffb848e2210e3500cd483",
},
"1.3": {
"groups": 5,
"pages": 68,
- "removed": 26,
+ "removed": 29,
"scopedLinks": 10,
"treeSha256":
"e8c9b0a64dac6dd3e47827ec5072697eb7d3ed79659e0b5c4a9c5df8e1408d38",
},
"1.0": {
"groups": 5,
"pages": 59,
- "removed": 24,
+ "removed": 28,
Review Comment:
Important: the `1.0` build generates `removed: 27`, not 28, so
`versioning.py validate --version 1.0` fails with `Docs navigation metadata
mismatch for 1.0` and the site build stops. Set `"removed": 27` for `1.0`. The
`Build and deploy site` run at `1a27da8` failed on this check, and
`data/docs_nav.json` and this file have not changed since.
--
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]