Merged
docs: add English translations for markdown files #182
docs: add English translations for markdown files #182
Merged
jenny_xiangAdd on 10 days ago
jenny_xiang
10 days ago

描述

新增英文译稿,本次变更:

  • 新增 examples/README_en.md、examples/fast_kernel_launch_example/README_en.md
  • 新增 .gitcode/PULL_REQUEST_TEMPLATE.en-US.md(对应 zh-CN 模板的英文版)
  • 为 examples/add_example/README_en.md、examples/add_example_aicpu/README_en.md 补充语言切换行

译稿中指向本仓库的链接均已改写为对应的英文文档路径。

关联的Issue

无

测试

文档变更,已核对译稿链接有效性与格式,无需功能测试。

文档更新

本次变更全部为文档(.md)新增与更新,详见描述。

类型标签

likedislike
Pull Request has been successfully merged by CANN-robot.
(Thank you for jenny_xiang's contribution.)
Jjenny_xiang
10 days ago Created pull request, commit 0d55f3ed
atomgit-bot
atomgit-bot
10 days ago Comments:

变更摘要

本次变更为纯文档更新,目的是为示例工程补齐英文译稿。新增了 examples/README_en.md、examples/fast_kernel_launch_example/README_en.md 以及 .gitcode/PULL_REQUEST_TEMPLATE.en-US.md,并在已有的 examples/add_example/README_en.md、examples/add_example_aicpu/README_en.md 中补入中英文语言切换入口行,使仓库英文文档体系与中文文档对齐。

主要改动

  • 新增示例总览英文文档: examples/README_en.md 提供 AI Core 与 AI CPU 算子的概览说明、add_example 与 add_example_aicpu 的目录结构注释,以及包含 fast_kernel_launch_example 的算子开发样例表格,链接指向 ../docs/en/develop/aicore_develop_guide.md、aicpu_develop_guide.md 等英文文档路径。
  • 新增 PyTorch 快速开发样例英文文档: examples/fast_kernel_launch_example/README_en.md 描述环境依赖(GCC、Python、PyTorch>=2.6.0、TorchNPU)、python3 -m build --wheel -n 构建与安装步骤、torch.ops.ascend_ops.add 快速上手示例,以及新增算子的开发流程(schema 注册、Meta 函数、AscendC kernel、RunOpApi 调用注册)。
  • 新增英文 PR 模板: .gitcode/PULL_REQUEST_TEMPLATE.en-US.md 对应 zh-CN 模板,包含 Description、Related Issue、Tests、Documentation Update、Type Label 等章节,供英文提交者使用。
  • 补充语言切换行: 在 examples/add_example/README_en.md 与 examples/add_example_aicpu/README_en.md 标题后加入 English | [简体中文](./README.md) 链接行,与新增总览文档的头部格式保持一致。

🧩 本次 Review 已使用自定义 Skill:

likedislike
Incorrect?
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

Hi @jenny_xiang, welcome to submitting your first PR to CANN!

PR Merge Steps

1. CLA Signing

If the current PR label includes cann-cla/yes, it means you have signed the CLA and can proceed to the next step. If the label includes cann-cla/no, please sign the CLA first. If you have any questions, please refer to the FAQ.

2. CI Check

Please comment /compile to trigger the CI pipeline check. If the CI run is successful, the PR will be tagged with ci-pipeline-passed and you can proceed to the next step. If the CI run fails, the PR will be tagged with ci-pipeline-failed, please check the CI logs to fix the issues in the PR. If you have any questions, please refer to the FAQ.

3. Code Review

After CI passes, please refer to the PR Approval Progress and proactively @ the committers in the table to review the code. After approval, committers will comment /lgtm and /approve. Once the lgtm and approved labels are successfully added, the PR will be merged automatically.

likedislike
atomgit-bot
atomgit-bot
10 days ago Comments:

代码审查

✅ 未发现问题


🧩 本次 Review 已使用自定义 Skill:

likedislike
Incorrect?
CANN-robotCANN-robotCollaborators
10 days ago Added label: cann-cla/yes
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

CLA Signature Pass

jenny_xiang, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.


PR Approval Progress

✅ Congratulations! All modules have met the lgtm and approve requirements.

Module Approval Details

module lgtm status approve status
.gitcode/** ✅ Larry_liuyi, yue-ma (2/2) ✅ Larry_liuyi (1/1)
repo-cann/ops-ras ✅ 柳宗谷, yue-ma (2/2) ✅ 柳宗谷, yue-ma (2/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)
likedislike
CANN-robotCANN-robotCollaborators
10 days ago Set mywaaagh_admin,songchangxia,tanghaoran7,shentukangjun,FelixTang7,yu-xinjie62,yue-ma,zhou-qilong,rxtfeng,loov1,LiuZonggu,chenxingyu18,llimwang,Larry_liuyi,gubaocheng as approver
CANN-robotCANN-robotCollaborators
10 days ago Set mywaaagh_admin,songchangxia,tanghaoran7,shentukangjun,FelixTang7,yu-xinjie62,yue-ma,zhou-qilong,rxtfeng,loov1,LiuZonggu,chenxingyu18,llimwang,Larry_liuyi,gubaocheng as approver
jenny_xiang
10 days ago Comments:

/compile

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Added label: ci-pipeline-running
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

流水线任务触发成功
任务链接 [2386e6e8a4694774819f3c6973fa843d][流水线指导]

任务名称状态日志下载链接
PreSmoke_ATK_Test_A2 ✅ SUCCESS >>>>>

[2026-10-28 16:41:57]    CI执行结束

likedislike
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

流水线任务触发成功
任务链接 [a5635041d96e499fb9e5e502a9df9921][流水线指导]

任务名称状态日志下载链接
Compile_Ascend_X86 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single ✅ SUCCESS >>>>> >>>>>
pre_comment ✅ SUCCESS >>>>>
Compile_Ascend_X86_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single_ubuntu24 ✅ SUCCESS >>>>> >>>>>
UT_Test_ophost ✅ SUCCESS
UT_Test_opapi ✅ SUCCESS
API_Check ✅ SUCCESS >>>>>

[2026-10-28 16:44:03]    CI执行结束

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Added label: api-check-pass
CANN-robotCANN-robotCollaborators
10 days ago Removed label: api-check-pass
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

流水线任务触发成功
任务链接 [046d3004caa34db28d181f4e2372af3f][流水线指导]

任务名称状态日志下载链接
codecheck ✅ SUCCESS >>>>>
SCA ✅ SUCCESS >>>>>
antipoison ✅ SUCCESS >>>>>
codecheck_Pr ❌ FAILED
codecheck_codestyle ✅ SUCCESS >>>>>
codecheck_precommit ⚠️ WARNING >>>>> >>>>>
likedislike
CANN-robotCANN-robotCollaborators
10 days ago Removed label: ci-pipeline-running
CANN-robotCANN-robotCollaborators
10 days ago Added label: ci-pipeline-failed
jenny_xiang
10 days ago Comments:

/compile

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Removed label: ci-pipeline-failed
CANN-robotCANN-robotCollaborators
10 days ago Added label: ci-pipeline-running
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

流水线任务触发成功
任务链接 [b0dc2410318747b3b8535d01c1522eda][流水线指导]

任务名称状态日志下载链接
PreSmoke_ATK_Test_A2 ✅ SUCCESS >>>>>

[2026-10-29 09:00:54]    CI执行结束

likedislike
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

流水线任务触发成功
任务链接 [3a73c9b2fc1d4ee2961700f8d0e54a7f][流水线指导]

任务名称状态日志下载链接
Compile_Ascend_X86 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single ✅ SUCCESS >>>>> >>>>>
pre_comment ✅ SUCCESS >>>>>
Compile_Ascend_X86_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single_ubuntu24 ✅ SUCCESS >>>>> >>>>>
UT_Test_ophost ✅ SUCCESS
UT_Test_opapi ✅ SUCCESS
API_Check ✅ SUCCESS >>>>>

[2026-10-29 09:02:53]    CI执行结束

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Added label: api-check-pass
LiuZongguCollaborators
10 days ago Comments:

/approve

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Removed label: api-check-pass
CANN-robot
CANN-robotCollaborators
10 days ago Comments:

流水线任务触发成功
任务链接 [f96cd70a88e6491aa4bc3ed45187cab3][流水线指导]

任务名称状态日志下载链接
codecheck ✅ SUCCESS >>>>>
SCA ✅ SUCCESS >>>>>
antipoison ✅ SUCCESS >>>>>
codecheck_Pr ✅ SUCCESS
codecheck_codestyle ✅ SUCCESS >>>>>
codecheck_precommit ⚠️ WARNING >>>>> >>>>>

[2026-10-29 09:07:33]    CI执行结束

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Removed label: ci-pipeline-running
CANN-robotCANN-robotCollaborators
10 days ago Added label: ci-pipeline-passed
刘怡Collaborators
10 days ago Comments:

/approve
/lgtm

likedislike
CANN-robotCANN-robotCollaborators
10 days ago Added label: approved
yue-maCollaborators
9 days ago Comments:

/approve
/lgtm

likedislike
CANN-robotCANN-robotCollaborators
9 days ago Added label: lgtm
CANN-robotCANN-robotCollaborators
9 days ago Merged pull request