Merged
modified md files #13602
gitee-duhuipingAdd on 18 days ago
modified md files #13602
Merged
gitee-duhuipingAdd on 18 days ago
gitee-duhuiping
gitee-duhuipingCollaborators
18 days ago

描述

Modify issues.

关联的Issue

#7337

#7474
#7941
#6792
#7345

测试

Only involves updating the MD document description, does not involve testing.

文档更新

md files

类型标签

likedislike
Pull Request has been successfully merged by CANN-robot.
(Thank you for gitee-duhuiping's contribution.)
gitee-duhuipinggitee-duhuipingCollaborators
18 days ago Created pull request, commit b374b28a
gitee-duhuipinggitee-duhuipingCollaborators
18 days ago Associated issue: [Documentation|文档问题]: norm/group_norm: aclnn 文档将总体方差写成样本方差,[Documentation|文档反馈]: aclnnRmsNorm 资料 gamma 约束「n < x_shape.dims()」与「维度 1-8」互斥:rank-1 输入无合法 gamma
atomgit-bot
atomgit-bot
18 days ago Comments:

变更摘要

本 PR 为纯文档更新,未涉及代码逻辑或测试,主要修正 norm/group_norm/docs/aclnnGroupNorm.md 与 norm/rms_norm/docs/aclnnRmsNorm.md 两个算子接口文档中的术语表述与参数约束描述,使 aclnnGroupNorm 的方差定义和 aclnnRmsNorm 中 gamma 的 shape 取值范围与实现语义一致。

主要改动

  • aclnnGroupNorm 方差术语修正: 将计算公式说明中的 Var[x] 由“样本方差”修改为“总体方差”,明确归一化使用的是总体方差定义。
  • aclnnRmsNorm 的 gamma 形状约束放宽: gamma 的 shape 约束由 gamma_shape = x_shape[n:], n < x_shape.dims() 改为 n ≤ x_shape.dims(),允许 n 取到 x_shape.dims() 的边界值。

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

likedislike
Incorrect?
atomgit-bot
atomgit-bot
18 days ago Comments:

代码审查

审查结论

本次变更仅涉及两个 Markdown 文档,已逐文件检视:

变更文件 结论
norm/group_norm/docs/aclnnGroupNorm.md 修改方向正确(公式分母为 1/n,确是总体方差,与 README:45 一致),但英文文档 aclnnGroupNorm_en.md:31 未同步,仍写 sample variance —— 1 个发现(P3)
norm/rms_norm/docs/aclnnRmsNorm.md 约束由 n < dims() 放宽为 n ≤ dims() 属于过度放宽:n = dims() 时 gamma_shape = () 为 0 维,与同表 gamma「维度 1-8」冲突,且原 issue 的立论(rank-1 无解)在数学上不成立;英文文档 aclnnRmsNorm_en.md:98 及同族文档也未同步 —— 2 个发现(P2×1、P3×1)

发现统计

  • P0:0
  • P1:0
  • P2:1(rms_norm n ≤ dims() 导致 gamma 0 维与「维度 1-8」自相矛盾)
  • P3:2(rms_norm 中英文文档口径分叉;group_norm 中英文文档口径分叉)

总体风险判断

无编译/构建/运行期风险,属纯文档影响。但两处改动均为「单侧修改」:group_norm 的中文修正方向正确却漏改英文;rms_norm 的放宽则进一步引入了新的文档自相矛盾(n = dims() 对应 0 维 gamma),建议按 P2 那条改回严格上界并显式补全 0 ≤ n < dims() 与 n = 0 的语义,随后统一中英文与同族文档口径后再合入。

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

💬 仅评论


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

likedislike
Incorrect?
CANN-robotCANN-robotCollaborators
18 days ago Added label: cann-cla/yes
52 messages are collapsed here。 See more
liujie12345678
liujie12345678Collaborators
17 days ago Comments:

/lgtm
/approve

likedislike
CANN-robotCANN-robotCollaborators
17 days ago Added label: lgtmapproved
CANN-robotCANN-robotCollaborators
17 days ago Closed associated issue
CANN-robotCANN-robotCollaborators
17 days ago Merged pull request
CANN-robot
CANN-robotCollaborators
17 days ago Comments:

Pull Request 已合并或已关闭。

If you want to solve this problem, you can click here to do it in the FAQs.

likedislike