UIengF opened a new pull request, #520:
URL: https://github.com/apache/hugegraph-doc/pull/520

   ## Purpose of the PR
   
   Add English and Chinese HugeGraph-MCP usage guides and make them 
discoverable from the HugeGraph-AI overview and sidebar. Users can install the 
published package, configure a STDIO client, verify a connection, and 
understand the supported query/schema/write boundaries and optional AI 
prerequisites.
   
   The guides distinguish published `hugegraph-mcp==1.7.1` behavior from 
current-source `core`/`legacy` toolsets and future aligned releases. They 
document separate graph/AI connection settings, authentication and write gates, 
refresh target checks, and why raw Gremlin and other registered operations can 
remain disabled.
   
   Paired implementation: 
[apache/hugegraph-ai#382](https://github.com/apache/hugegraph-ai/pull/382). 
Coordinate the current-source guidance with that code PR; the published-package 
installation remains explicitly pinned.
   
   This PR independently applies the same five documentation/navigation files 
to `apache/hugegraph-doc:master` at `ec9ae7b`: **5 files, +461/-0**. It carries 
no changes to the target repository's CI, theme, or site runtime.
   
   ## Validation
   
   - Fresh warning-strict `scripts/hugo.sh build` passed on this target branch 
(Hugo Extended 0.165.0, Go 1.27.0, repository-pinned OINK 1.2.0).
   - Complete `bash dist/validate-links.sh` passed in an isolated Linux 
container using copies of the current content/assets and the unchanged 
validator with Windows CRLF normalized to LF.
   - Current `tests/e2e/search-ranking.spec.js`: **24 passed**, against this 
target's fresh artifact in Edge Chromium.
   - English and Chinese pages at 1440 x 1000 and 390 x 844: page heading, 
overview-to-guide navigation, counterpart-language link, desktop sidebar, 
desktop MCP search/navigation, and no horizontal overflow passed.
   - `git diff --check` passed. Before/after images below were regenerated from 
this target's current base and topic builds.
   - Full Python 3.13 source suite was attempted on Windows: **257 tests, 9 
failures, 41 errors, 1 skipped**. It is **not a passing source-suite run**: 
observed blockers include symlink privileges, POSIX process/script assumptions, 
missing image tooling and path-separator assertions. Linux CI is still 
required; no source test was weakened or disabled.
   
   ## Before / after
   
   | View | Before | After |
   | --- | --- | --- |
   | EN desktop | 
![Before](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/en-desktop-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/en-desktop-after-overview.png)
 |
   | EN mobile | 
![Before](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/en-mobile-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/en-mobile-after-overview.png)
 |
   | CN desktop | 
![Before](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/cn-desktop-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/cn-desktop-after-overview.png)
 |
   | CN mobile | 
![Before](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/cn-mobile-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache/cn-mobile-after-overview.png)
 |
   
   [New guide screenshots and capture 
details](https://github.com/UIengF/hugegraph-doc/tree/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/apache)
 are stored on a separate evidence branch.
   


-- 
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