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


Incorrect?
atomgit-bot
18 days ago Comments:
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:


Incorrect?
18 days ago Added label: cann-cla/yes
52 messages are collapsed here。 See more
liujie12345678
17 days ago Comments:
17 days ago Comments:
/lgtm
/approve


17 days ago Added label: lgtmapproved
17 days ago Closed associated issue
17 days ago Merged pull request
CANN-robot
17 days ago Comments:
17 days ago Comments:
Pull Request 已合并或已关闭。
If you want to solve this problem, you can click here to do it in the FAQs.


描述
Modify issues.
关联的Issue
#7337
#7474
#7941
#6792
#7345
测试
Only involves updating the MD document description, does not involve testing.
文档更新
md files
类型标签