# PR #27308 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs: sync legacy docs/-only updates into docs_new (Mintlify)
- 合并时间：2026-06-05 10:45
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/27308

---

## 执行摘要

本 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/` 中，恢复两个文档树的一致性。

## 实现拆解

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` 和 `mint broken-links` 确认无编译错误和断链。

### 本 PR 不涉及源码变更，故无关键源码片段。

## 评论区精华

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

## 风险与影响

风险较低，主要包括 MDX 语法错误、断链、未来再次不同步的可能性。所有风险已通过工具验证和明确的跳过策略缓解。
影响主要在文档层面：用户现在可在 Mintlify 站点看到完整的最新文档；团队需注意后续文档变更应优先同步到 `docs_new/`。

## 关联脉络

本 PR 与 #23001（Mintlify 站点引入）直接相关，并解决了因多个 PR（如 #23047、#23378、#24491 等）仅更新 legacy `docs/` 导致的同步问题。随着 mintlify 成为主要文档站点，未来此类批量同步的必要性应逐步降低。