Skip to content

docs: translate test framework documentation to English#1754

Open
ravindra-RKB wants to merge 1 commit into
kmesh-net:mainfrom
ravindra-RKB:issue-1751-translate-test-docs
Open

docs: translate test framework documentation to English#1754
ravindra-RKB wants to merge 1 commit into
kmesh-net:mainfrom
ravindra-RKB:issue-1751-translate-test-docs

Conversation

@ravindra-RKB

Copy link
Copy Markdown

What does this PR do?

Translates the Kmesh test framework documentation from Chinese to English.

Changes

translate test framework introduction
translate mugen section
translate test execution guide
translate test framework API reference
translate test case authoring guide

Verification

verified translation scope
preserved markdown structure
preserved code blocks
preserved links
preserved examples
verified only intended files changed

Fixes #1751

AI assistance was used during preparation. All changes were manually reviewed and verified before submission.

Copilot AI review requested due to automatic review settings June 14, 2026 16:45
@kmesh-bot kmesh-bot requested review from YaoZengzeng and lec-bit June 14, 2026 16:45
@kmesh-bot

Copy link
Copy Markdown
Collaborator

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign lec-bit for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@gemini-code-assist

Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on localizing the Kmesh test framework documentation. By translating the existing Chinese documentation into English, the project aims to lower the barrier to entry for international contributors and streamline the onboarding process for new developers interacting with the testing infrastructure.

Highlights

  • Documentation Translation: Translated the Kmesh test framework documentation from Chinese to English to improve accessibility for the global community.
  • Content Coverage: The translation covers the test framework introduction, mugen integration, test execution guides, API references, and test case authoring instructions.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.


The docs were in a script so rare, / Now English words are everywhere. / The tests run smooth, the path is clear, / For all the world to see and hear.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

This PR updates the test framework README by translating and rewriting it into English to make the Kmesh test framework usage clearer for a broader audience.

Changes:

  • Replaced the original Chinese README content with an English version.
  • Clarified directory structure, execution steps, and how to inspect logs/tmp files.
  • Documented common libs APIs and how to add new test cases.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread test/README.md

- Replace the kernel series packages containing the Kmesh enhancement patch (kernel.rpm, kernel-devel.rpm, kernel-header.rpm)

- For how to build kernel series packages containing the Kmesh enhancement patch, please refer to: xxx
Comment thread test/README.md

- Pre-test preparation

- Prepare a linux development environment (e.g., openEuler 2203 LTS)
Comment thread test/README.md

- Function description

Start Kmesh in local mode, this mode does not require deploying k8s/istio in the environment;
Comment thread test/README.md Outdated
# 2 Compile Kmesh code + Kmesh.ko, and install
# 3 Execute each test case in the test suite one by one
# 4 Output the test execution results, as follows
Tue Oct 25 19:29:50 2022 - INFO - 配置文件加载完成...
Comment thread test/README.md
```sh
[root@dev kmesh]# pwd
/home/Kmesh/test/testcases/kmesh
[root@dev kmesh]# tree oe_test_lb_policy_function/
Comment thread test/README.md
"name": "oe_test_base_function"
},
{
"name": "oe_test_lb_policy" # Add test case to the test suite
Comment thread test/README.md
Tue Oct 25 19:29:59 2022 - INFO - The case exit by code 0.
Tue Oct 25 19:29:59 2022 - INFO - End to run testcase:oe_test_normal_function.
Tue Oct 25 19:29:59 2022 - INFO - A total of 1 use cases were executed, with 1 successes and 0 failures.
the following test cases run successful

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request translates the Kmesh test framework documentation in test/README.md from Chinese to English. The reviewer pointed out that a log message in the example output ('配置文件加载完成...') was left untranslated and provided a suggestion to translate it to English for consistency.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread test/README.md Outdated
# 2 Compile Kmesh code + Kmesh.ko, and install
# 3 Execute each test case in the test suite one by one
# 4 Output the test execution results, as follows
Tue Oct 25 19:29:50 2022 - INFO - 配置文件加载完成...

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The log message '配置文件加载完成...' was left untranslated. Since this PR translates the documentation to English, please translate this log line as well (e.g., to 'Configuration file loaded successfully...').

Suggested change
Tue Oct 25 19:29:50 2022 - INFO - 配置文件加载完成...
Tue Oct 25 19:29:50 2022 - INFO - Configuration file loaded successfully...

Signed-off-by: Ravindra Kumar Bundela <ravindrarkb1205@gmail.com>
@ravindra-RKB ravindra-RKB force-pushed the issue-1751-translate-test-docs branch from e8b2a56 to 430c0e7 Compare June 14, 2026 16:51
@ravindra-RKB

Copy link
Copy Markdown
Author

@maintainers

Thanks for taking a look.

I have addressed the automated review feedback and verified that the translation preserves the original structure, examples, links, and code blocks while making the documentation accessible to English-speaking contributors.

Could you please take a look when you have time?

Thank you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Translate test framework documentation from Chinese to English

3 participants