执行摘要
PR#2411 从文档首页 docs/index.md 删除了手写维护的 ## Latest updates 更新日志区块。该列表长期无人更新、最新条目已过时数月,且全部六条内容均已在站点导航中存在独立页面,删除后首页从硬件要求部分直接进入 ## Start here 引导区。这是一次低风险的纯文档清理,对代码、测试与部署链路零影响。
功能与动机
PR body 明确提出核心判断:首页的手写 changelog 只有在有人每次发布都刷新时才有意义,而实际上没人维护,最新条目已经过期,读者会把首页误读为『自那以后没有新功能』。被删列表包含六条内容:
- CLI Reference 参数参考
- INT4 W4A16 QAT
- Unified VLM/LLM multi-turn rollout
- Rollout Routing Replay (R3) for MoE
- Unified FP8 pipeline
- Speculative decoding with online MTP-SFT
这些功能都已各自拥有独立文档页并出现在导航中,因此删除不会造成信息缺失。作者还确认没有页面链接到 #latest-updates 锚点,不存在断链风险。该 PR 是对文档维护成本的主动收敛,而非简单删内容。
实现拆解
- 变更入口:
docs/index.md 是唯一改动文件,删除硬件要求说明之后的 ## Latest updates 小节及其 6 条 Markdown 链接列表。
- 引用检查:PR body 明确说明没有页面链接到
#latest-updates 锚点,因此删除不会产生断链,无需修改其他文件。
- 结构衔接:删除后首页从硬件配置段落直接过渡到
## Start here 引导区,读者路径更连贯。
- 配套改动:无测试、无配置、无部署配套;站点索引
docs/docs.json 也未改动,保持现有导航结构不变。
本 PR 为纯文档 Markdown 删除,不涉及任何源码逻辑,没有可展示的关键源码片段。被删除内容仅为首页中一段手写更新列表,其完整内容已在『功能与动机』中列出。
评论区精华
本 PR 没有 review 评论、行内讨论或 issue 评论(comments_count 与 review_comments_count 均为 0)。唯一审核者 yueming-yuan 直接给予 APPROVED,未提出异议,说明该文档清理方案在团队内没有争议。
风险与影响
风险:极低。仅删除 6 行文档列表,无代码逻辑变更;已确认不存在指向 #latest-updates 锚点的链接,避免断链;被删内容对应的六个功能页均可通过导航访问。唯一可能的影响是部分读者习惯从首页聚合查看更新,但该列表早已过期,实际信息价值有限。
影响:范围限于文档站首页 docs/index.md。对用户而言首页更精简、导航指向更明确;对团队而言消除了一个需要每次发布手动同步的维护负担。对系统代码、CI、测试均无影响。
关联脉络
该 PR 与近期文档站整理工作一脉相承:PR#2383 重写 README 并同步调整 docs/index.md 首页结构,PR#2400 为文档站补齐 SEO 元数据,PR#2395 删除重复的 Platforms 章节并统一硬件清单。它们共同的方向是减少重复信息、避免手写内容腐化、让每个功能只有单一权威入口。本 PR 进一步贯彻了这一思路,把首页职责收窄为引导入口而非新闻聚合器。
参与讨论