已关闭
[Documentation|文档反馈]: AI Core算子开发指南中 Tiling实现 / Kernel实现 / UT验证 目录锚点无法跳转 #4392
Yeats_Liao创建于  18 天前关闭于  16 天前
Yeats_Liao
Yeats_Liao
18 天前 创建

Thanks for sending an issue! Please fill in the following template to help quickly solve your problem.

Document Link(文档链接)

https://atomgit.com/cann/ops-transformer/blob/master/docs/zh/develop/aicore_develop_guide.md
(同类问题同时存在于 docs/zh/develop/aicpu_develop_guide.md)

Issues Section(问题文档片段)

aicore_develop_guide.md:

  • 第 26 行:3. [Tiling实现](#Tiling实现):实现Host侧算子Tiling函数。
  • 第 28 行:4. [Kernel实现](#Kernel实现):实现Device侧算子核函数。
  • 第 459 行:1. [UT验证](#UT验证): 验证交付件代码能否正常运行。
    对应标题:
  • 第 126 行:## Tiling实现
  • 第 255 行:## Kernel实现
  • 第 463 行:### UT验证

aicpu_develop_guide.md:

  • 第 15 行:3. [Kernel实现](#Kernel实现):实现Device侧算子核函数。
  • 第 92 行:## Kernel实现

Existing Issues(存在的问题)

GitCode(与 GitLab 一致)在渲染 Markdown 标题时,会自动为标题生成小写锚点 id,例如 ## Tiling实现 的实际 id 是 tiling实现。但正文目录 / 正文中的跳转链接使用的是首字母大写形式 #Tiling实现#Kernel实现#UT验证,大小写不一致,导致点击跳转链接时无法定位到对应章节,锚点失效。这是文档内部导航缺陷,会影响读者按目录跳转阅读。

建议修正

将正文链接中的锚点统一改为小写,与标题实际生成的 id 保持一致:

  • #Tiling实现#tiling实现
  • #Kernel实现#kernel实现
  • #UT验证#ut验证

(或反过来把标题改为全小写形式,保持链接与标题大小写一致即可。)

likedislike
weihao18成员
18 天前 评论:

/assign @weihao18

likedislike
CANN-robotCANN-robot成员
18 天前 将 weihao18 设为负责人
Wweihao18成员
18 天前 关联了pull request:docs: 修复开发指南目录锚点大小写与标题id不一致导致跳转失效
CANN-robotCANN-robot成员
16 天前 关闭了 issue
CANN-robotCANN-robot成员
16 天前 添加了label:resolved