已合并
[Doc] 修复文档失效链接并补齐缺失的 SVDQuant 量化模式描述 #487 #866
rookie_hongchuan创建于 8 天前
[Doc] 修复文档失效链接并补齐缺失的 SVDQuant 量化模式描述 #487 #866
已合并
Pull Request已成功合入, 合并人@ascend-robot
(感谢 rookie_hongchuan 的贡献)8 天前 关联了issue:[Doc]: 修复 quantization_basic/quantization_mode 文档中的失效链接
atomgit-bot
8 天前 评论:
8 天前 评论:
变更摘要
该 PR 为纯文档修复(Issue #487),针对 docs/zh/knowledge_base/ 下 quantization_basic、quantization_mode 两节文档及引用 quantization_mode 的 quantization_format 文档中的失效相对链接进行全量修正,使相关词条页与总览页的链接均可达。通过脚本对全部 markdown 相对链接做存在性校验,共定位 8 个文件、21 处失效引用,修复后该范围内失效链接降为 0 处;无接口、输出件及兼容性变更。
主要改动
quantization_basic词条链接修正:term_int4.md、term_quantization.md中将quantization_algorithms/gptq/gptq.md、laos/laos.md分别改为实际的词条文件名gptq/term_gptq.md、laos/term_laos.md(词条文件均以term_<name>.md命名,不存在<name>.md)。quantization_mode词条链接修正:fa_quantization/README.md中fa3_quant/fa3_quant.md改为fa3_quant/term_fa3_quant.md;linear_layer_quantization/README.md中svdquant/svdquant.md、linear_quant/linear_quant.md分别改为svdquant/term_svdquant.md、linear_quant/term_linear_quant.md。quantization_format引用修正:README.md、ascendv1/term_ascendv1.md、compressed_tensors/term_compressed_tensors.md、mindie_sd/term_mindie_sd.md中引用不存在的quantization_mode/term_quantization_mode.md统一改指实际存在的总览页quantization_mode/README.md。


AtlasAccount
8 天前 评论:
8 天前 评论:
atomgit-bot
8 天前 评论:
8 天前 评论:
🤖 本次改动均为数据 / 生成 / 二进制文件(如测试用例、锁文件、媒体资源),没有可审查的代码逻辑,已跳过 AI 代码审查。


8 天前 添加了label:ascend-cla/yes
此处折叠了97条消息 查看更多
6 天前 添加了label:docs-ci-pipeline-success
libowen
3 天前 评论:
3 天前 评论:
/lgtm


3 天前 添加了label:approvedlgtm
3 天前 合入了pull request
1. 影响面评估
接口变更(按需): 无
输出件变更(按需): 无
非兼容变更(按需): 无
SIG 评审结论(按需): 无(纯文档改动,无接口/兼容性影响)
2. 修改描述
修改背景: Issue #487:master 分支
quantization_basic/quantization_mode两节文档存在失效的相对链接(渲染为 404)。背景之二:
SVDQuant作为量化模式此前缺少独立的模式描述——quantization_mode/README.md模式索引与linear_layer_quantization/README.md模式清单虽已列出 SVDQuant 行(含承载 IR 类),但其链接指向不存在的svdquant/svdquant.md(算法侧实际文件名为term_svdquant.md),且quantization_mode/linear_layer_quantization/下并无term_svdquant.md词条页,量化模式描述处于缺失状态。修改目的: ① 修复全部失效链接,使
quantization_basic/quantization_mode及直接引用quantization_mode的quantization_format文档相对链接全部可达;② 补齐此前缺失的 SVDQuant 量化模式描述——新增模式词条页,使模式索引/清单可稳定指向该词条。修改内容:
term_int4.md、term_quantization.md中quantization_algorithms/gptq/gptq.md→gptq/term_gptq.md、laos/laos.md→laos/term_laos.md(实际词条文件名为term_<name>.md,不存在<name>.md)。fa_quantization/README.md:fa3_quant/fa3_quant.md→fa3_quant/term_fa3_quant.md;linear_layer_quantization/README.md:linear_quant/linear_quant.md→linear_quant/term_linear_quant.md(×2);SVDQuant 行由失效的../../quantization_algorithms/svdquant/svdquant.md改指本目录新增的term_svdquant.md;quantization_mode/README.md模式索引:SVDQuant 行改指linear_layer_quantization/term_svdquant.md。README.md、ascendv1/term_ascendv1.md、compressed_tensors/term_compressed_tensors.md、mindie_sd/term_mindie_sd.md中引用不存在的quantization_mode/term_quantization_mode.md(quantization_mode 总览页实际为quantization_mode/README.md),统一改指quantization_mode/README.md。ascendv1/ascendv1_usage.md中指向msmodelslim/core/quant_service/modelslim_v1/save/interface.py的相对路径链接(差一级../,渲染 404),移除链接、保留AscendV1SaveInterface类名文本。quantization_mode/linear_layer_quantization/term_svdquant.md(按《量化术语百科词条模板》及01_term_glossary_checklist.md校验编写),并在term_w4a4_dynamic.md关联词条补充对该词条的反向引用。概念域参考: 不涉及代码概念域(docs)。
3. 功能验证
复现命令:
# 链接校验脚本:遍历 docs/zh/knowledge_base 下全部 md,解析相对链接并用 os.path 校验目标存在性 # 修复前:quantization_basic/quantization_mode 范围 9 处失效;修复后 0 处。4. 自检(请逐项确认,不适用标 N/A)
典型安全编码问题
DT