Closed
[Documentation|文档反馈]: aclnnClippedSwigluV2.md 文档存在 1 处问题需修正 #8620
liujing987913Add on  10 days agoClosed at  5 days ago
liujing987913
liujing987913Collaborators
10 days ago Create

文档链接:https://gitcode.com/cann/ops-nn/blob/master/activation/clipped_swiglu/docs/aclnnClippedSwigluV2.md

问题片段:

  1. 文档:新增了一个输入参数:clamp_mode

存在的问题:

  1. 文档:同一文档中同一概念(新增的输入参数)表述不一致:功能说明与计算公式中写作 clamp_mode(下划线命名),而函数原型、参数说明表格、公式分支说明及返回值列表均写作 clampMode(驼峰命名),;建议修改为 新增了一个输入参数:clampMode

注:以上问题由自动化工具比对文档与规范发现,建议同类文档一并排查。

likedislike
liujing987913liujing987913Collaborators
10 days ago Added label: documentation
yuning_chen
yuning_chenCollaborators
10 days ago Comments:

感谢反馈,已确认该文档问题。

需修正:1. 文档:同一文档中同一概念(新增的输入参数)表述不一致:功能说明与计算公式中写作 clamp_mode(下划线命名),而函数原型、参数说明表格、公式分支说明及返回值列表均写作 clampMode(驼峰命名),;建议修改为 新增了一个输入参数:clampMode

处理建议:按上述修改点修正文档对应片段(https://gitcode.com/cann/ops-nn/blob/master/activation/clipped_swiglu/docs/aclnnClippedSwigluV2.md);同时建议顺带排查同目录下同类文档是否有相同表述(反馈中提到的问题由自动化工具比对发现,同类文档可能一并存在)。修正后在本 issue 回贴修改后的片段,便于验证关闭。

likedislike
yuning_chenyuning_chenCollaborators
10 days ago Assign east_yang as responsible person
yuning_chen
yuning_chenCollaborators
10 days ago Comments:

已指派给 @east_yang 跟进。

指派依据:责任田 ClippedSwiglu arch22 接口人

likedislike
east_yangeast_yangCollaborators
9 days ago Assign fengying555682 as responsible person
east_yangeast_yangCollaborators
9 days ago Removed responsible person east_yang
fengying555682fengying555682Collaborators
5 days ago Associated pull request
CANN-robotCANN-robotCollaborators
5 days ago Close issue
CANN-robotCANN-robotCollaborators
5 days ago changed custom state from 待办的 to 已完成
CANN-robotCANN-robotCollaborators
5 days ago Added label: resolved
chenjiayi_chenjiayi_Collaborators
3 days ago Assign chenjiayi_ as responsible person
chenjiayi_
chenjiayi_Collaborators
3 days ago Comments:

补充说明本问题的跟进安排:

该 issue 已关闭,已补充 assign 给 @chenjiayi_ 复核关闭结论,原责任人 @fengying555682 保留协同。

当前状态:

  • 关闭状态:已完成;复核项:aclnnClippedSwigluV2.md 文档存在 1 处问题需修正。
  • 我先核对关闭时的结论与当前 master 的实现/资料是否一致。

下一步:

  • 复核完成后在本 issue 补充结论。
  • 如果还有后续需要,请重新提 issue。
likedislike
chenjiayi_
chenjiayi_Collaborators
3 days ago Comments:

补充说明本问题的后续处理:

已修复并随关联 PR 合入。

处理结果:

验证:

  • 关联 PR(2026-11-16)已合入,变更可从 PR 记录追溯。
  • 本次以 PR 记录与 issue 讨论核对为主,未重新执行复现或真机验证。

说明:合入分支与版本以 PR 记录为准;如仍有问题,请重新提 issue 并附版本、shape 与日志。

如果还有后续需要,请重新提 issue。

likedislike
chenjiayi_chenjiayi_Collaborators
19 hours ago Removed responsible person chenjiayi_