imbajin opened a new pull request, #557:
URL: https://github.com/apache/hugegraph-doc/pull/557
## Purpose of the PR
1. **Unify Client & API Navigation**:
- Eliminate semantic duplication in the sidebar between "Clients and
APIs" (`/docs/clients/`) and "HugeGraph Client" (`/docs/quickstart/client/`).
- Group multi-language client libraries into a dedicated secondary
directory (`/docs/clients/client/`) covering Java, Python, and Go SDKs.
- Consolidate Java Client quickstart and comprehensive API reference into
a unified, streamlined Java Client guide.
- Maintain 100% backward compatibility with previous URLs through Hugo
`aliases` and `data/version_routes.json` equivalents.
2. **Graph Query Language & Cypher Integration**:
- Integrate Cypher language guides, compatibility matrix, and Neo4j
migration guide into `/docs/language/`.
- Update navigation and index cards to present both Gremlin and Cypher
query languages side-by-side.
- Optimize table presentation using OINK native `.wide` and `.expand`
block attributes.
## What is included
- `content/{cn,en}/docs/clients/_index.md`: Updated overview with OINK
`{.cards}` pointing to Client SDKs, RESTful API, and Gremlin Console.
- `content/{cn,en}/docs/clients/client/_index.md`: New index for client SDKs.
- `content/{cn,en}/docs/clients/client/hugegraph-client.md`: Consolidated
Java client documentation with `aliases`.
- `content/{cn,en}/docs/clients/client/hugegraph-client-python.md`:
Relocated Python client documentation with `aliases`.
- `content/{cn,en}/docs/clients/client/hugegraph-client-go.md`: Relocated Go
client documentation with `aliases`.
- `content/{cn,en}/docs/language/`: Integrated Cypher and Gremlin guides
with improved table readability.
- `data/docs_nav.json`: Materialized five-group navigation tree with updated
`clients` hierarchy.
- `data/version_routes.json`: Updated latest routes and multi-version
equivalents.
- `scripts/versioning.py`: Updated latest navigation statistics checksum and
expected page count.
## Validation
- `bash dist/validate-links.sh`: Passed with 0 broken links.
- `python3 -m unittest discover -s scripts/`: All 290 tests passed.
- Hugo bilingual site build: Verified all pages and aliases build cleanly.
--
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]
