# PR #27240 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Docs] re-organize nemotron cookbook
- 合并时间：2026-06-04 15:40
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/27240

---

## 执行摘要

此 PR 对 NVIDIA Nemotron 系列 cookbook 文档进行重新组织：调整了侧边栏页面顺序，将 Nemotron3-Ultra 置于首位；更新了介绍页面的链接；清理了元数据格式，删除了过时的 `NEW` 标记。属于纯文档调整，无代码风险。

## 功能与动机

PR 旨在优化 Nemotron 系列文档的导航体验，将最受关注的 Nemotron3-Ultra 模型在侧边栏和介绍卡片中置于突出位置，同时清理过时的元数据信息，使文档结构更清晰。

## 实现拆解

1. **调整介绍页面的 NVIDIA 卡片链接**：在 `docs_new/cookbook/autoregressive/intro.mdx` 中，将 NVIDIA 卡片的目标链接从 `Nemotron3-Nano-Omni` 改为 `Nemotron3-Ultra`，使分类页面的首推模型更新为 Ultra 版本。

2. **调整导航侧边栏页面顺序**：在 `docs_new/docs.json` 配置中，将 NVIDIA 组内页面顺序重新排列，把 `Nemotron3-Ultra` 移至列表最前方，使其在侧边栏中排在最前。

3. **优化 Nemotron3-Ultra 文档元数据**：在 `docs_new/cookbook/autoregressive/NVIDIA/Nemotron3-Ultra.mdx` 中，将 `description` 提升到 Frontmatter 的一级字段，删除冗余的 `metatags` 层级，保持与其他文档一致的格式。

4. **清理 Nemotron3-Nano-Omni 的标记**：在 `docs_new/cookbook/autoregressive/NVIDIA/Nemotron3-Nano-Omni.mdx` 中删除 `tag: NEW` 标记，因为该模型早已发布，不再需要强调“新”。

### `docs_new/docs.json`:
```json
{
  "group": "NVIDIA",
  "pages": [
    "cookbook/autoregressive/NVIDIA/Nemotron3-Ultra",  /* 移到最前 */
    "cookbook/autoregressive/NVIDIA/Nemotron3-Nano-Omni",
    "cookbook/autoregressive/NVIDIA/Nemotron3-Nano",
    "cookbook/autoregressive/NVIDIA/Nemotron3-Super"
  ]
}

```

`docs_new/cookbook/autoregressive/intro.mdx`:
```markdown
<Card title="NVIDIA" mode="card"
      href="/cookbook/autoregressive/NVIDIA/Nemotron3-Ultra"  /* 从 Nemotron3-Nano-Omni 改为 Nemotron3-Ultra */
      img="/cards/logos/nvidia.png" />

```

## 评论区精华

Gemini Code Assist 自动总结了变更内容，未提出具体问题。另一 reviewer `wisclmy0611` 直接批准。无实质性讨论。

## 风险与影响

- **风险**：极低。仅涉及文档配置和元数据，无代码或模型行为变更。
- **影响**：用户通过侧边栏访问 Nemotron3-Ultra 将更加方便；Nemotron3-Nano-Omni 的 `NEW` 标记被移除，符合其已发布状态。

## 关联脉络

该 PR 是对 PR #26969 （新增 Nemotron3-Ultra cookbook）的后续整理，使新 cookbook 能够更好地融入现有导航体系。