Prhub

#6359 [doc] chore: fix ascend doc link

原始 PR 作者 hustmf 合并时间 2026-05-15 10:23 文件变更 1 提交数 1 评论 1 代码增减 +6 / -6

执行摘要

修复 Ascend 教程文档的链接错误

Ascend 教程文档在近期重构中移动或重命名了多个文件,但目录文件 README.md 中的链接未同步更新,导致用户点击后无法访问目标页面。本 PR 旨在修正这些链接,确保文档导航正常。

该 PR 是常规文档维护,合并已通过审核,无需进一步操作。对于 review 中提出的路径疑似重复问题,建议后续验证 parameter_and_metrics.md 是否确实承载了 verl特性支持 的内容,若不然可另开 PR 修正。

讨论亮点

Review 中 gemini-code-assist[bot] 指出一个潜在问题:第 30 行的 [verl特性支持] 链接被改为 ./dev_guide/model_dev/parameter_and_metrics.md,与第 43 行 [训练参数与指标] 的路径一致,怀疑是复制粘贴错误。该评论未得到回复,但 PR 最终被 wucong25 批准合并。说明该路径可能确实是 verl特性支持 文档的正确新位置(对应 parameter_and_metrics.md 文件)。

实现拆解

  1. 修复特性支持链接:将 [verl特性支持](./feature_support/support_verl_features.md) 更正为 ./dev_guide/model_dev/parameter_and_metrics.md,将 [NPU特性支持](./feature_support/npu_advance_features/npu_advance_features.md) 更正为 ./feature_support/npu_advance_features.md
  2. 修复模型开发链接:将 [训练参数与指标](./dev_guide/model_dev/parameters_and_metrics.md) 更正为 ./dev_guide/model_dev/parameter_and_metrics.md(文件名中 parametersparameter)。
  3. 修复精度调试链接:将 [精度分析](./dev_guide/precision_analysis/precision_alignment.md) 更正为 ./dev_guide/precision_analysis/precision_alignment_zh.md,将 [精度调试器](./dev_guide/precision_analysis/precision_debugger.md) 更正为 ./dev_guide/precision_analysis/precision_debugger_zh.md(文件添加了 _zh 后缀)。
  4. 修复性能调优链接:将 [profiling采集](./dev_guide/performance/ascend_profiling_zh.md) 更正为 ./dev_guide/performance/ascend_profiling_zh.rst(扩展名 .md.rst)。
  5. 仅修改一个文件:所有变更集中在 docs/ascend_tutorial/README.md,无其他文件改动。
文件 模块 状态 重要度
docs/ascend_tutorial/README.md 文档 modified 2.23

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

verl 特性支持链接可能指向错误文档 正确性

gemini-code-assist[bot] 指出第 30 行 verl 特性支持 的链接被改为与第 43 行训练参数与指标相同的路径,怀疑是复制粘贴错误。

结论:PR 作者未回应,但 PR 被批准合并。推测该路径已是正确目的(parameter_and_metrics.md 同时涵盖特性支持内容)。 · 已解决

风险与影响

风险极低。仅涉及文档链接文本修改,不影响任何代码逻辑。唯一风险是 [verl特性支持] 的链接可能指向了错误的文档(与 训练参数与指标 相同),但这在功能上仅是导航问题,不会造成运行时错误。

影响范围很小,仅作用于 Ascend 教程目录页的链接导航。对用户而言,修复了 6 个死链,改善了文档阅读体验。对系统无影响。

文档链接校对 低风险

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论