已合并
[Doc][master] 修改26.1.0下链接跳转到master的问题 #729
[Doc][master] 修改26.1.0下链接跳转到master的问题 #729
已合并
tanxiangyuu创建于 7月15日
tanxiangyuu
tanxiangyuu成员
7月15日

PR 提交说明

提交前请阅读 CONTRIBUTING.md,开发者文档:模型接入指南

PR 标题前缀:[Doc]

1. 影响面评估

接口变更(按需): 无

▎ 备注:仅修改 Markdown 文档中的链接,无 CLI、API、YAML 等变更。

输出件变更(按需): 无

▎ 备注:仅文档内链调整,不涉及导出格式、产物路径等变更。

非兼容变更(按需): 无

▎ 备注:纯文档修改,无非兼容变更。

SIG 评审结论(按需): 无

▎ 提醒:非兼容、安全风险等高危 PR 须经 SIG 评审后合入;无则保留「无」。

2. 修改描述

修改背景(可选): docs/zh/ 和 example/ 中的链接直接指向 gitcode.com/.../blob/master/ 或 readthedocs.io/zh-cn/latest/,在 master 分支上可以正常跳转,但拉取分支后链接指向仍是 master,导致版本迭代时需反复修改链接。

修改目的: 将仓库内文档中的外链统一替换为相对路径,避免版本迭代拉分支导致的链接问题。

修改内容:(按「概念 - 变化」分条)

  • doc/文档链接:将 docs/zh/ 和 example/ 下 26 个 markdown 文件中的 gitcode.com/Ascend/msmodelslim/blob/master/、tree/master/ 以及 msmodelslim.readthedocs.io/zh-cn/latest/ 链接替换为仓库内相对路径
  • 同时将文档链接的书名号规范化([《文本》] → 《[文本]》),完整句子补全句号

3. 功能验证

冒烟由 CI 门禁检查,无需填写「冒烟是否通过」。

复现步骤(可选):

4. 自检(请逐项确认,不适用标 N/A)

典型安全编码问题

DT

likedislike
Pull Request已成功合入, 合并人@ascend-robot
(感谢 tanxiangyuu 的贡献)
atomgit-bot
atomgit-bot
7月15日 评论:

变更摘要

这是一个纯文档修复 PR,主要将 docs/zh(中文文档)和 example 目录中遗留的 master 分支链接统一更新为新的目标分支名,涉及 26 个文件,共约 97 行新增、98 行删除。该变更不涉及任何接口、输出件或非兼容改动。

主要改动

  • docs/zh 中文文档中的分支链接修复:将 docs/zh 目录下多个文档文件中残留的 master 分支引用(如 URL 中的 /blob/master//tree/master/ 等路径片段)替换为正确的目标分支名,确保文档内链接指向有效。
  • example 目录中的分支链接修复:同步更新 example 目录下示例相关文件中的 master 链接引用,保持示例代码与文档描述一致。
  • 批量路径替换:涉及 26 个文件的定向修改,增删行数基本对等(97 新增 vs 98 删除),表明是精准的字符串替换操作,未改变文档结构与内容逻辑。
likedislike
atomgit-bot
atomgit-bot
7月15日 评论:

代码审查

经过对全部 26 个变更文件的逐一审查,所有相对路径的目录深度计算均正确无误,所有目标文件/目录均存在。

本 PR 将原本指向 https://gitcode.com/Ascend/msmodelslim/blob/master/...(强制跳转到 master 分支)和 https://msmodelslim.readthedocs.io/zh-cn/latest/...(ReadTheDocs 外部链接)的链接替换为仓库内的相对路径。此更改方式与代码库中已大量存在的模式一致。未发现路径错误、安全风险或其他实质性问题。

审查结论

  • P0: 0
  • P1: 0
  • P2: 0
  • P3: 0

整体风险评估:低风险。 本次变更为纯文档链接修复,所有相对路径正确,仅涉及 Markdown 文档中的 URL 替换。


各文件审查确认汇总

文件 审查结论
docs/zh/contributing/contributing_guide.md 无问题(3处链接替换,路径正确)
docs/zh/development_guide/iformat_integration_guide.md 无问题(13处链接替换,路径正确)
docs/zh/development_guide/integrating_models.md 无问题(6处链接替换,路径正确)
docs/zh/development_guide/integrating_multimodal_generation_model.md 无问题(12处链接替换+1处尾随空格清理)
docs/zh/development_guide/integrating_multimodal_understanding_model.md 无问题(14处链接替换,路径正确)
docs/zh/release_notes/release_notes.md 无问题(3处链接替换,路径正确)
docs/zh/user_guide/feature_guide/auto_precision_tuning/usage.md 无问题(2处链接替换,路径正确)
docs/zh/user_guide/feature_guide/traditional_quantization_v0/foundation_model_quantization_and_calibration.md 无问题(3处链接替换,路径正确)
docs/zh/user_guide/feature_guide/traditional_quantization_v0/inference_optimization_for_multimodal_generative_model.md 无问题(5处链接替换,路径正确)
docs/zh/user_guide/quantization_algorithms/outlier_suppression_algorithms/quarot.md 无问题(4处链接替换,路径正确)
docs/zh/user_guide/quantization_algorithms/outlier_suppression_algorithms/smooth_quant.md 无问题(2处链接替换,路径正确)
docs/zh/user_guide/quantization_algorithms/quantization_algorithms/fa3_quant.md 无问题(1处链接替换,路径正确)
docs/zh/user_guide/quantization_algorithms/quantization_algorithms/gptq.md 无问题(1处链接替换,路径正确)
docs/zh/user_guide/quantization_algorithms/quantization_algorithms/histogram_activation_quantization.md 无问题(2处链接替换,路径正确)
docs/zh/user_guide/quantization_algorithms/quantization_algorithms/minmax.md 无问题(1处链接替换,路径正确)
docs/zh/user_guide/quantization_algorithms/quantization_algorithms/pdmix.md 无问题(3处链接替换,路径正确)
example/GLM-5/README.md 无问题(1处链接替换,路径正确)
example/GLM4-MOE/README.md 无问题(2处链接替换,路径正确)
example/HunYuan/README.md 无问题(2处链接替换,合并了相邻两条列表项,路径正确)
example/multimodal_sd/HunYuanVideo/README.md 无问题(3处链接替换,路径正确)
example/multimodal_sd/OpenSoraPlanV1_2/README.md 无问题(1处链接替换,路径正确)
example/multimodal_sd/QwenImageEdit/README.md 无问题(4处链接替换,路径正确)
example/multimodal_sd/README.md 无问题(1处链接替换,路径正确)
example/multimodal_sd/SD3/README.md 无问题(1处链接替换,路径正确)
example/multimodal_sd/Wan2_1/README.md 无问题(4处链接替换,路径正确)
example/multimodal_sd/Wan2_2/README.md 无问题(3处链接替换,路径正确)
类型 数量
🔴 阻塞 10
🟡 建议 0

⛔ 需要修改

likedislike
ascend-robotascend-robot成员
7月15日 添加了label:stat/needs-squash
ascend-robotascend-robot成员
7月15日 添加了label:ascend-cla/yes
此处折叠了83条消息 查看更多
ascend-robotascend-robot成员
7月15日 添加了label:docs-ci-pipeline-success
joejoezhou成员
7月15日 评论:

/lgtm
/approve

likedislike
ascend-robotascend-robot成员
7月15日 添加了label:approvedlgtm
ascend-robotascend-robot成员
7月15日 合入了pull request
ascend-robot
ascend-robot成员
7月15日 评论:

Pull Request 已合并或已关闭。

If you want to solve this problem, you can click here to do it in the FAQs.

likedislike