已关闭
[Doc]: 量化模式词条「词条类别」头部元数据链接指向错误(16 个文件) #459
rookie_hongchuan创建于  18 天前关闭于  4 天前
rookie_hongchuan成员
18 天前 创建

Documentation Location | 文档位置

受影响目录:docs/zh/knowledge_base/quantization_mode/ 下三个子类别的全部词条文件,共 16 个:

  • 线性层量化(12 个):linear_layer_quantization/term_w8a8_fp8_dynamic.mdterm_w8a16_static.mdterm_w8a8_dynamic.mdterm_w8a8_static.mdterm_w8a8_mx_dynamic.mdterm_w8a8_pdmix.mdterm_w4a4_dynamic.mdterm_w4a4_mx_dynamic.mdterm_w4a4_mx_dualscale.mdterm_w4a8_dynamic.mdterm_w4a8_mx_dynamic.mdterm_w16a16s.md
  • FA 量化(3 个):fa_quantization/term_fa_perblock.mdterm_fa_perhead.mdterm_fa_pertoken.md
  • KVCache 量化(1 个):kv_cache_quantization/term_kv_cache_perchannel.md

代表链接:
https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/knowledge_base/quantization_mode/linear_layer_quantization/term_w8a8_fp8_dynamic.md
https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/knowledge_base/quantization_mode/linear_layer_quantization/term_w8a16_static.md

Current Content Description | 文档问题描述

词条文件位于子类别目录下,其直接父级类别是当前目录的 README.md(如 linear_layer_quantization/README.md 即「线性层量化」)。但 16 个词条文件顶部信息框的 **词条类别** 字段中,类别链接一律写成了 ../README.md

> **词条类别**:量化数据格式([线性层量化](../README.md))

从词条文件所在目录解析,../README.md 指向的是上一层 quantization_mode/README.md(即「量化模式」),而不是锚文本所声称的「线性层量化」。锚文本与链接目标不一致。

典型例子:

  1. term_w8a8_fp8_dynamic.md:头部词条类别写着「线性层量化」,但链接 ../README.md 实际跳到上一层「量化模式」。
  2. term_w8a16_static.md:同样问题——第 4 节关联词条中「线性层量化」链接为 [线性层量化](README.md)(指向当前目录类别 README,正确),与头部元数据的 ../README.md 不一致。

fa_quantization/kv_cache_quantization/ 下词条同理:[FA 量化](../README.md)[KVCache 量化](../README.md) 均错误指向「量化模式」。

Modification Suggestion | 修改建议

将 16 个词条文件顶部信息框 **词条类别** 中的链接由 ../README.md 改为 README.md(指向当前子目录的类别 README),与第 4 节关联词条中的既有正确写法保持一致:

  • [线性层量化](../README.md)[线性层量化](README.md)(linear_layer_quantization/ 下 12 个)
  • [FA 量化](../README.md)[FA 量化](README.md)(fa_quantization/ 下 3 个)
  • [KVCache 量化](../README.md)[KVCache 量化](README.md)(kv_cache_quantization/ 下 1 个)

改动仅限词条头部元数据链接,不涉及正文与章节内容。

likedislike
Rrookie_hongchuan成员
18 天前 添加了label:document
anreywmh成员
18 天前 评论:

👋 您好,欢迎向 MindStudio msModelSlim 提交 Issue!
我们已收到您的反馈,感谢你对开源社区的支持。🎉

📅处理时效: 维护团队将在24小时内 查看并回复您的问题(工作日)。
🔍自助查询: 在等待期间,建议您先查阅以下资料,可能已有解决方案:

📖 MindStudio msModelSlim 官方文档
📝 贡献者指南

请确保 Issue 描述清晰,包含复现步骤和日志,这将帮助我们更快定位问题。谢谢!

likedislike
Aanreywmh成员
18 天前 添加了label:triaged
Rrookie_hongchuan成员
18 天前 关联了pull request:[Doc] 修正量化模式词条「词条类别」头部链接指向(Fix #459)
Rrookie_hongchuan成员
18 天前 将 rookie_hongchuan 设为负责人
rookie_hongchuan成员
18 天前 评论:

补充说明:修复 PR #839 过程中,CI link-validity 检查发现 e4848d87(分解量化算法文档)将算法文档拆分为 term_/usage_ 后,本 issue 涉及的 16 个词条文件内对算法文档的 40 处引用仍指向旧单文件,已一并修复(按锚文本语义指向 usage_* 或 term_*)。

likedislike
rookie_hongchuan成员
15 天前 评论:

/label add resovled

likedislike
ascend-robot
ascend-robot成员
15 天前 评论:

Label Command Feedback

The repository doesn't have the label(s) resovled, it cannot be added!

likedislike
rookie_hongchuan成员
15 天前 评论:

/label add resolved

likedislike
ascend-robotascend-robot成员
15 天前 添加了label:resolved
ascend-robot
ascend-robot成员
8 天前 评论:

您好,当前Issue标记为resolved且有一段时间未进一步更新,因此我们将其标记为'stale'(闲置)状态。若您认为这是误操作,可通过添加任意评论来去除'stale'标签。标记为stale的Issue在4天内无更新活动将自动关闭。

likedislike
ascend-robotascend-robot成员
8 天前 添加了label:stale
ascend-robotascend-robot成员
4 天前 关闭了 issue