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]

Reply via email to