已合并
产品文档中的png文件命名英文化 #1229
chenjiao创建于 28 天前
产品文档中的png文件命名英文化 #1229
已合并
chenjiao创建于 28 天前
chenjiao成员
28 天前

描述

产品文档中的png图片名由中文改为英文

关联的Issue

#634

测试

NA

文档更新

png和相关的link md

类型标签

  • [x ] 📝 文档更新
likedislike
Pull Request已成功合入, 合并人@CANN-robot
(感谢 chenjiao 的贡献)
Cchenjiao成员
28 天前 创建了 pull request,commit 17f864b1
atomgit-bot
atomgit-bot
28 天前 评论:

变更摘要

此 PR 主要对产品文档中引用的 PNG 图片文件进行命名英文化处理,将原本使用中文命名的图片文件名统一改为英文命名,并在对应的文档文件中更新图片引用路径。属于纯文档规范化改动,不涉及代码逻辑变更。

主要改动

  • 图片文件名英文化:将产品文档目录下的多个 PNG 图片文件从中文命名改为英文命名,以提升跨平台兼容性和可维护性。
  • 文档引用路径同步更新:在 42 个文档文件中同步更新了对应的图片引用路径,确保文档中的图片链接指向新的英文命名文件,总计涉及少量行数的增删(+49/-56)。
  • 类型标签为文档更新:该 PR 明确定位为文档更新(📝),不涉及 Bug 修复、新特性或代码重构等变更。
likedislike
atomgit-bot
atomgit-bot
28 天前 评论:

代码审查

关闭总结

审查结果

文件 审查结论
CONTRIBUTING.md 无问题 — 仅将图片引用从中文名改为英文名,目标文件存在
docs/zh/context/quant_mode_introduction.md 发现1个问题(P2):MX量化描述中存在拼写错误 gourp
docs/zh/context/sparse_mode_introduction.md 发现1个问题(P3):相邻章节 **说明** 格式不一致
docs/zh/debug/cann_sim.md 无问题 — 仅图片引用英文化
docs/zh/develop/cross_platform_migration_guide.md 无问题 — 仅4处图片引用英文化,目标文件均存在
docs/zh/invocation/quick_op_invocation.md 无问题 — 仅2处图片引用英文化,目标文件均存在
objdetect/anchor_response_flags/README.md 无问题 — HTML表格转Markdown,修复了原有失效链接,目标文件存在
objdetect/to_absolute_b_box/README.md 无问题 — 表格格式整理、移除多余空行、更新描述文本
objdetect/yolo/README.md 无问题 — 仅在两处列表前添加空行以改善Markdown渲染

按优先级统计

  • P0: 0
  • P1: 0
  • P2: 1(gourpgroup 拼写错误)
  • P3: 1(**说明** 冒号不一致)

整体风险判断

低风险。本次变更是文档图片文件名的英文化及少量格式整理,所有重命名后的图片文件均已确认存在。唯一需要注意的是 MX 量化描述中新引入的拼写错误 gourp(应为 group),建议在合入前修正。

类型 数量
🔴 阻塞 0
🟡 建议 1

💬 仅评论

likedislike
CANN-robotCANN-robot成员
28 天前 添加了label:cann-cla/yes
chenjiao成员
28 天前 评论:

compile

likedislike
Cchenjiao成员
28 天前 update merge request[project id: 7657293, iid: 1229, commit_id: e3aa4c4f163de2a881763b63d2892f8203c46888] virtual merging success
CANN-robot
CANN-robot成员
28 天前 评论:

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


PR Approval Progress

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

Module Approval Details

module lgtm status approve status
*/*/README.md 周文芳, 刘伟, zhangzijie (3/2) 周文芳 (1/1)
repo-cann/ops-cv zhangzijie, 刘伟 (2/2) zhangzijie, 刘伟 (2/1)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)

CLA Signature Pass

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

likedislike
CANN-robotCANN-robot成员
28 天前 将zhou-qilong,gitee-duhuiping,rxtfeng,loov1,zhangzijie,zl_hw,liu-wei,pingchuantang,llimwang,zhouwenfang,gubaocheng,wuyao51511,caiwenwen设为评审人
CANN-robotCANN-robot成员
28 天前 将zhou-qilong,gitee-duhuiping,rxtfeng,loov1,zhangzijie,zl_hw,liu-wei,pingchuantang,llimwang,zhouwenfang,gubaocheng,wuyao51511,caiwenwen设为审查人
CANN-robotCANN-robot成员
28 天前 添加了label:ci-pipeline-running
CANN-robot
CANN-robot成员
28 天前 评论:

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

任务名称状态日志下载链接
Compile_Ascend_X86 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_experimental ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_experimental ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_A5 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_A5 ✅ SUCCESS >>>>> >>>>>
pre_comment ✅ SUCCESS >>>>>
Compile_Pre ✅ SUCCESS >>>>>
Compile_Ascend_X86_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_experimental_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_A5_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_experimental_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_A5_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_X86_monitor_910b ✅ SUCCESS >>>>> >>>>>
Compile_X86_monitor_910c ✅ SUCCESS >>>>> >>>>>
Compile_X86_monitor_950 ✅ SUCCESS >>>>> >>>>>
Compile_classify ✅ SUCCESS >>>>>
Compile_Ascend_X86_mobile_station_9030_ubuntu24 ✅ SUCCESS >>>>> >>>>>
UT_Test ✅ SUCCESS
PreSmoke_A900 ✅ SUCCESS >>>>>
API_Check ✅ SUCCESS >>>>>
PreSmoke_ATK_Test_A2 ✅ SUCCESS >>>>>
UT_Test_harmony-infer-chs-cv ✅ SUCCESS
UT_Test_harmony-infer-cpro-cv ✅ SUCCESS
UT_Test_report_lcov ✅ SUCCESS

[2026-08-04 21:01:22]    CI执行结束

likedislike
CANN-robot
CANN-robot成员
28 天前 评论:

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

任务名称状态日志下载链接
SCA ✅ SUCCESS >>>>>
antipoison ✅ SUCCESS >>>>>
codecheck_checkpr ✅ SUCCESS
StaticCheck_codespell ⚠️ WARNING >>>>>
StaticCheck_link_validity ✅ SUCCESS
StaticCheck_resource_existence ✅ SUCCESS
StaticCheck_tag_closed ✅ SUCCESS
StaticCheck_markdownlint ✅ SUCCESS
codecheck_precommit ✅ SUCCESS >>>>>

[2026-08-04 20:53:22]    CI执行结束

likedislike
Cchenjiao成员
28 天前 修改了pull request 的描述
zhouwenfang
zhouwenfang成员
28 天前 评论:

/approve

likedislike
CANN-robotCANN-robot成员
28 天前 添加了label:api-check-pass
CANN-robotCANN-robot成员
28 天前 删除了label:ci-pipeline-running
CANN-robotCANN-robot成员
28 天前 添加了label:ci-pipeline-passed
atomgit-bot
atomgit-bot28 天前进行代码检视1
docs/zh/context/quant_mode_introduction.md
@@ -57,3 +57,3 @@
5757 - perblock-perblock量化模式(简称B-B量化模式)
5858- 伪量化:一般是指对权重矩阵(weight)进行量化的模式,包括perchannel量化模式(简称C量化模式)。
59-- mx量化:本质是Microscaling量化,通过动态调整缩因子,在极低比特下如1bit保持模型精度。这里指pergroup-pergroup量化模式(简称G-G量化模式)是对于量化参数类型为FLOAT8_E8M0group size为32的特例。
59+- MX量化Microscaling Formats):指由开计算项目OCP制定的低精度数据表示方式属于pergroup量化模式,表示量化参数类型为FLOAT8\_E8M0gourp size为32的特例情况
atomgit-bot
atomgit-bot28 天前评论:

🟡 Medium Priority

changed line → affected behavior/contract → failure mode → suggested fix

docs/zh/context/quant_mode_introduction.md 第59行,此diff将MX量化的描述从旧版本重写为新版本。新版本的描述中出现了拼写错误:gourp size 应为 group size

旧版本原文(已删除)中正确使用了 group size,新版本引入了一个打字错误 gourp(字母顺序颠倒)。此错误会直接呈现在产品文档中,对读者造成困惑,属于文档准确性问题。

触发条件:任何读者阅读该文档时都会看到此拼写错误。

建议:将 gourp 修正为 group

改动建议
59
- - MX量化(Microscaling Formats):指由开放计算项目(OCP)制定的低精度数据表示方式。属于pergroup量化模式,表示量化参数类型为FLOAT8\_E8M0且gourp size为32的特例情况。
59
+ - MX量化(Microscaling Formats):指由开放计算项目(OCP)制定的低精度数据表示方式。属于pergroup量化模式,表示量化参数类型为FLOAT8\_E8M0且group size为32的特例情况。
应用建议
likedislike
zhangzijie成员
28 天前 评论:

/lgtm
/approve

likedislike
CANN-robotCANN-robot成员
28 天前 添加了label:approved
liu-wei
liu-wei成员
28 天前 评论:

/lgtm
/approve

likedislike
CANN-robotCANN-robot成员
28 天前 添加了label:lgtm
CANN-robotCANN-robot成员
28 天前 解决了最后一个问题
CANN-robotCANN-robot成员
28 天前 合入了pull request