已关闭
驱动文档目录索引未反映实际目录 #178
KaranocaVe创建于  9月25日关闭于  24 天前
KaranocaVe
KaranocaVe
9月25日 创建

驱动文档目录索引未反映实际目录

docs/README.md 和 docs/README_en.md 的目录树漏列了四组已存在的 Ascend 950 文档,并把图片目录标在 docs/figures。固定提交 6ce0252e607d7d9257694475ecaafefc77c43832 中,图片实际位于 docs/zh/figures 和 docs/en/figures,docs/figures 不存在;msnpureport 仅存在于中文目录。

读者按入口索引无法发现 Ascend 950 的 DCMI、HCCN、npu-smi 和升级指南,也可能按错误路径查找图片。预期目录索引应与中英文文档树一致。

修复只更新中英文 README 中的目录示例,列出实际存在的目录并将图片路径放在对应语言目录下;不涉及驱动实现或运行行为。

Validation

验证记录

  • 基线:cann/driver master 6ce0252e607d7d9257694475ecaafefc77c43832。对照 docs/zh/、docs/en/ 的 Git tree,确认两处均有四个 Ascend 950 目录和 figures/,msnpureport 仅在中文目录,docs/figures 不存在。
  • 补丁:两份 README 的目录修改在固定基线上可应用;仅这两份文件有变化,保留其原 CRLF 行尾后 whitespace 检查通过。
  • 目标仓库规则:按文档更新类型填写 PR 模板;修改仅为目录示例,不适用驱动构建或 NPU 测试。

关联 PR: https://gitcode.com/cann/driver/merge_requests/167

likedislike
KaranocaVeKaranocaVe
9月25日 修改了issue 的描述
KaranocaVeKaranocaVe
9月25日 关联了pull request:修正驱动文档目录索引
KaranocaVeKaranocaVe
9月25日 修改了issue 的描述
KaranocaVeKaranocaVe
9月25日 修改了issue 的描述
Aad_cx成员
9月28日 issue类型由 任务 改变为 文档
Aad_cx成员
9月28日 将 ad_cx 设为负责人
ad_cx成员
9月28日 评论:

感谢关注,文档问题核实后确实存在,贡献的pr将在检视后合入

likedislike
ad_cx成员
26 天前 评论:

你好,对应pr检视意见请及时处理,并联系合入

likedislike
KaranocaVe
KaranocaVe
26 天前 评论:

已按 PR 检视意见处理:中英文目录示例均移除了重复的 docs/ 前缀,并将改动保持为单提交 66955175aa635ef6201335f3c39a502251e6c11a。当前 head 的编译检查正在执行,麻烦维护者按最终提交复检。

likedislike
KaranocaVe
KaranocaVe
26 天前 评论:

PR 检视意见已按要求处理并推送至当前 head 66955175aa635ef6201335f3c39a502251e6c11a,该提交的 ci-pipeline-passed 已通过。我已在原检视讨论回复,请按最终提交复检;若无其他问题,麻烦有合入权限的成员协助合入。

likedislike
ad_cx成员
24 天前 评论:

关联PR已合入,本问题关闭,感谢贡献

likedislike
Aad_cx成员
24 天前 issue状态由 进行中 改变为 已完成
Aad_cx成员
24 天前 关闭了 issue
CANN-robotCANN-robot成员
24 天前 添加了label:resolved
KaranocaVe
KaranocaVe
13 天前 评论:

@ad_cx 您好,这个 Issue 对应的修复已经合入:https://gitcode.com/cann/driver/merge_requests/167

开发者计划反馈,Issue 需要有 Accepted 标签才能计入积分,仅关闭或标记 resolved 还不够。目前这条 Issue 尚未标记 Accepted,麻烦您结合问题和已合入的修复复核一下;确认符合受理条件后,帮忙补上 Accepted 标签。

感谢您的支持!

likedislike