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

   ## 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: 
[hugegraph/hugegraph-ai#81](https://github.com/hugegraph/hugegraph-ai/pull/81). 
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 `hugegraph/hugegraph-doc:master` at `6181c87`: **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: **255 tests, 9 
failures, 39 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/hugegraph/en-desktop-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph/en-desktop-after-overview.png)
 |
   | EN mobile | 
![Before](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph/en-mobile-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph/en-mobile-after-overview.png)
 |
   | CN desktop | 
![Before](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph/cn-desktop-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph/cn-desktop-after-overview.png)
 |
   | CN mobile | 
![Before](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph/cn-mobile-before-overview.png)
 | 
![After](https://raw.githubusercontent.com/UIengF/hugegraph-doc/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph/cn-mobile-after-overview.png)
 |
   
   [New guide screenshots and capture 
details](https://github.com/UIengF/hugegraph-doc/tree/e45a84fdfc1e39b3eb94df022a00bd3ae92ca8d5/hugegraph)
 are stored on a separate evidence branch.
   
   Synchronized documentation PR: 
[apache/hugegraph-doc#520](https://github.com/apache/hugegraph-doc/pull/520), 
based independently on Apache master to keep both reviews scoped.
   
   
   Source-suite baseline comparison: the unmodified target master also failed 
on the same Windows toolchain (255 tests, 9 failures, 38 errors, 1 skipped). 
The set of failing test identities is identical between base and topic; varying 
error totals include Windows temporary-directory cleanup/locked-file errors 
(`WinError 32`/`WinError 5`). No new failing test identity was introduced by 
the five-file documentation patch. This comparison does not replace Linux CI.
   
   


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