Prhub

#27308 docs: sync legacy docs/-only updates into docs_new (Mintlify)

原始 PR 作者 zijiexia 合并时间 2026-06-05 10:45 文件变更 18 提交数 20 评论 1 代码增减 +650 / -29

执行摘要

同步遗留文档至 Mintlify 站点

Since the Mintlify documentation site (docs_new/) was introduced in #23001, a number of PRs landed documentation changes in the legacy docs/ tree only, so docs_new/ has drifted out of sync. This PR ports those docs/-only changes into the corresponding docs_new/ pages.

本 PR 为纯文档同步操作,技术复杂度低,但具有重要的维护意义。建议所有文档贡献者阅读此 PR 的 commits 列表以了解如何确保文档一致性。值得关注的决策:被跳过的 PR 清单和原因(避免回退更新的内容)。

讨论亮点

本 PR 在 review 过程中未产生实质性讨论,只有一个批准(来自 wisclmy0611)。

实现拆解

  1. 识别差异:对比 legacy docs/docs_new/ 的内容,找出仅更新了 docs/ 但未同步到 docs_new/ 的源 PR。
  2. 逐 PR 移植:每个源 PR 对应一个独立的 Git commit,将文档更改准确复制到对应的 docs_new/ 页面,同时调整以符合 Mintlify 的 MDX 约定(如 JSX 表格、大括号转义、跨文档链接的无扩展名写法、代码围栏标题等)。
  3. 创建新页面:新增 sglang-diffusion/deployment_cookbook.mdx,并在 docs.json 导航中注册。
  4. 跳过已同步内容:对于已在 docs_new/ 中存在且版本更新的 PR,直接跳过,避免回退内容。
  5. 验证:使用 mint dev 确认所有页面可编译且 HTTP 200 正常返回,使用 mint broken-links 确认无新增断链。
文件 模块 状态 重要度
docs_new/docs/sglang-diffusion/deployment_cookbook.mdx 扩散模型 added 5.28
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_quantization.mdx Ascend NPU modified 4.59
docs_new/docs/sglang-diffusion/quantization.mdx 扩散模型 modified 4.19
docs_new/docs/advanced_features/server_arguments.mdx 服务器参数 modified 4.11
docs_new/docs/hardware-platforms/xpu.mdx Intel XPU modified 4.1
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_qwen3_examples.mdx Ascend NPU modified 4.09

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险较低,主要包括:

  • MDX 语法错误:移植过程中可能引入格式问题,但已通过 mint dev 验证。
  • 断链:调整链接格式后可能导致内部跳转失效,但 mint broken-links 检查通过。
  • 未来再次不同步:当前 PR 只解决了历史欠账,若未来仍继续仅更新 docs/,则差距会再次出现。建议后续将 docs_new/ 作为唯一文档源。
  • 遗漏内容:可能有个别 PR 被无意跳过,但 PR body 明确列出了跳过的 PR 和理由。

对用户的影响:Mintlify 站点(docs_new/)现可正确反映近期所有文档更新,包括新的 server args、量化指南、XPU 部署、Ascend NPU 扩散模型量化等。
对团队的影响:确认了 docs_new/docs/ 的双向同步需求,提示未来文档贡献者应优先更新 docs_new/
影响范围集中在文档层面,无代码或用户运行行为变更。

文档断链风险 语法兼容风险 同步遗漏风险

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论