已关闭
[Bug-Report|缺陷反馈]: docs/zh/menu_aclnn_api.md 中 aclnnReflectionPad2dBackward 链接指向错误仓库路径 #2456
gcw_93rlw6ed创建于  8月1日关闭于  8月1日
gcw_93rlw6ed
8月1日 创建

一、问题描述 (必填)

文件 docs/zh/menu_aclnn_api.md 第 226 行存在一处失效链接,链接文本为 aclnnReflectionPad2dBackward,target 为 ../../conversion/pad_v4_grad/docs/aclnnReflectionPad2dBackward.md

该链接存在两个问题:

问题 1:链接 target 指向的文件不存在

conversion/pad_v4_grad/docs/ 目录下只有 aclnnReflectionPad1dBackward.md(注意是 1d),并没有 aclnnReflectionPad2dBackward.md

问题 2:真实文件位于另一个算子目录

全仓搜索 aclnnReflectionPad2dBackward.md,真实路径是 conversion/pad_v3_grad_replicate/docs/aclnnReflectionPad2dBackward.md,即该算子属于 pad_v3_grad_replicate 而非 pad_v4_grad

二、环境信息 (可选)

  • 仓库:cann/ops-math
  • 分支:master
  • 文件路径:docs/zh/menu_aclnn_api.md
  • 失效链接所在行:226
  • 验证方式:本地 clone master 分支后用 lsfind 验证

三、重现步骤 (可选)

  1. git clone -b master https://gitcode.com/cann/ops-math.git && cd ops-math
  2. 查看链接:sed -n '226p' docs/zh/menu_aclnn_api.md
    输出:- [aclnnReflectionPad2dBackward](../../conversion/pad_v4_grad/docs/aclnnReflectionPad2dBackward.md)
  3. 验证 target 不存在:ls conversion/pad_v4_grad/docs/aclnnReflectionPad2dBackward.md → No such file
  4. 查找真实路径:find . -name "aclnnReflectionPad2dBackward.md"./conversion/pad_v3_grad_replicate/docs/aclnnReflectionPad2dBackward.md
  5. 在 GitCode Web 界面打开 docs/zh/menu_aclnn_api.md,点击第 226 行 aclnnReflectionPad2dBackward 链接,跳转 404

四、预期结果 (可选)

修复 docs/zh/menu_aclnn_api.md 第 226 行链接 target,将仓库路径 pad_v4_grad 改为正确的 pad_v3_grad_replicate

  • 修复前:[aclnnReflectionPad2dBackward](../../conversion/pad_v4_grad/docs/aclnnReflectionPad2dBackward.md)
  • 修复后:[aclnnReflectionPad2dBackward](../../conversion/pad_v3_grad_replicate/docs/aclnnReflectionPad2dBackward.md)

五、修复建议 (可选)

该问题根因疑似菜单文档生成时把 aclnnReflectionPad2dBackward(属于 pad_v3_grad_replicate)误关联到 pad_v4_grad 仓库目录。建议:

  1. 修复本链接 target,将 pad_v4_grad 改为 pad_v3_grad_replicate
  2. 全仓扫描 docs/zh/menu_aclnn_api.mddocs/zh/op_api_list.md 中所有指向 conversion/pad_*/docs/ 的链接,校验 target 文件是否真实存在。
  3. 可在 CI 文档检查流程中增加「相对链接 target 必须真实存在」的校验。

💡 备注(选填)

本 issue 与 issue #2454(right_shift 算子文档失效链接)属同类问题,建议统一在 CI 中增加相对链接存在性校验。

likedislike
songkai111成员
8月1日 评论:

确实存在问题,已安排相关责任人修复

likedislike
Ssongkai111成员
8月1日 关联了pull request:fix: 修复多个文档中的失效链接(#2455/#2456/#2457/#2458/#2459)
CANN-robotCANN-robot成员
8月1日 关闭了 issue
CANN-robotCANN-robot成员
8月1日 添加了label:resolved