已关闭
[Bug-Report|缺陷反馈]: docs/zh/op_api_list.md 中 aclnnReflectionPad2dBackward 链接指向错误仓库路径 #2459
gcw_93rlw6ed创建于 8月1日关闭于 8月1日
songkai111
8月1日 评论:
8月1日 评论:
确实存在问题,已安排相关责任人修复


8月1日 关联了pull request:fix: 修复多个文档中的失效链接(#2455/#2456/#2457/#2458/#2459)
8月1日 关闭了 issue
8月1日 添加了label:resolved
一、问题描述 (必填)
文件
docs/zh/op_api_list.md第 256 行存在一处失效链接,链接文本为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。注:同仓
docs/zh/menu_aclnn_api.md第 226 行存在相同根因的失效链接(已在 issue #2456 中反馈),本 issue 针对op_api_list.md这一独立文件单独反馈。二、环境信息 (可选)
docs/zh/op_api_list.mdls和find验证三、重现步骤 (可选)
git clone -b master https://gitcode.com/cann/ops-math.git && cd ops-mathsed -n '256p' docs/zh/op_api_list.md输出:
| [aclnnReflectionPad2dBackward](../../conversion/pad_v4_grad/docs/aclnnReflectionPad2dBackward.md) | reflection_pad2d的反向传播,前向计算参考aclnnReflectionPad2d。 | 默认确定性实现| 默认确定性实现|ls conversion/pad_v4_grad/docs/aclnnReflectionPad2dBackward.md→ No such file or directoryfind . -name "aclnnReflectionPad2dBackward.md"→./conversion/pad_v3_grad_replicate/docs/aclnnReflectionPad2dBackward.mddocs/zh/op_api_list.md,点击第 256 行aclnnReflectionPad2dBackward链接,跳转 404四、预期结果 (可选)
修复
docs/zh/op_api_list.md第 256 行链接 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)五、修复建议 (可选)
该问题根因疑似 API 列表文档生成时把
aclnnReflectionPad2dBackward(属于 pad_v3_grad_replicate)误关联到pad_v4_grad仓库目录。与 issue #2456 同根因但不同文件,建议一并修复。建议:pad_v4_grad改为pad_v3_grad_replicate。docs/zh/menu_aclnn_api.md和docs/zh/op_api_list.md中所有指向conversion/pad_*/docs/的链接,校验 target 文件是否真实存在。💡 备注(选填)
本 issue 与 #2454/#2455/#2456 属同类文档失效引用问题,且与 #2456 同根因(menu_aclnn_api.md 第 226 行同链接),建议统一在 CI 中增加相对链接存在性校验。