执行摘要
本 PR 将多个仅更新 legacy docs/ 的 PR 的文档变更同步到 Mintlify 站点 docs_new/,确保文档一致性。新增一个部署 cookbook 页面,更新了 server args、量化指南、XPU 和 Ascend NPU 等页面。所有更改已通过编译和断链验证。
功能与动机
自 #23001 引入 docs_new/ 作为 Mintlify 文档站点后,部分 PR 只更新了 legacy docs/ 树,导致 docs_new/ 逐渐不同步。本 PR 的目标是将这些仅针对 docs/ 的更改移植到 docs_new/ 中,恢复两个文档树的一致性。
实现拆解
- 识别差异:对比 legacy
docs/ 与 docs_new/ 的内容,找出仅更新了 docs/ 但未同步到 docs_new/ 的源 PR。
- 逐 PR 移植:每个源 PR 对应一个独立的 Git commit,将文档更改准确复制到对应的
docs_new/ 页面,同时调整以符合 Mintlify 的 MDX 约定(如 JSX 表格、大括号转义、跨文档链接的无扩展名写法、代码围栏标题等)。
- 创建新页面:新增
sglang-diffusion/deployment_cookbook.mdx,并在 docs.json 导航中注册。
- 跳过已同步内容:对于已在
docs_new/ 中存在且版本更新的 PR,直接跳过,避免回退。
- 验证:使用
mint dev 和 mint broken-links 确认无编译错误和断链。
本 PR 不涉及源码变更,故无关键源码片段。
评论区精华
本 PR 在 review 过程中未产生实质性讨论,只有一个批准(来自 wisclmy0611)。
风险与影响
风险较低,主要包括 MDX 语法错误、断链、未来再次不同步的可能性。所有风险已通过工具验证和明确的跳过策略缓解。
影响主要在文档层面:用户现在可在 Mintlify 站点看到完整的最新文档;团队需注意后续文档变更应优先同步到 docs_new/。
关联脉络
本 PR 与 #23001(Mintlify 站点引入)直接相关,并解决了因多个 PR(如 #23047、#23378、#24491 等)仅更新 legacy docs/ 导致的同步问题。随着 mintlify 成为主要文档站点,未来此类批量同步的必要性应逐步降低。
参与讨论