执行摘要
本次 PR 在 docs_new/docs.json 配置文件中添加了一条从 /cookbook 到 /cookbook/intro 的显式重定向规则，以修复 Mintlify 文档站点中裸 URL 错误匹配到非预期页面（server_arguments）的问题。这是一个低风险、影响范围仅限于文档站点导航的配置维护性变更。
功能与动机
根据 PR 描述，Mintlify 文档生成器在解析裸 URL /cookbook 时存在一个缺陷：它会错误地匹配到导航栏中第一个符合 cookbook/* 模式的页面（即 server_arguments），而不是用户期望的“Cookbook”标签页的简介页面（/cookbook/intro）。这导致了错误的导航体验。添加显式重定向是为了覆盖默认的匹配逻辑，确保用户访问 /cookbook 时能正确跳转到介绍页面。
实现拆解
- 变更入口：修改
docs_new/docs.json 文件，这是 Mintlify 文档站点的核心配置文件。
-
核心逻辑改造：在配置文件的 redirects 数组中插入一个新的 JSON 对象。该对象定义了源路径（source）和目标路径（destination）。
{
"source": "/cookbook",
"destination": "/cookbook/intro"
}
这条规则告诉 Mintlify，当用户请求 /cookbook 时，应将其重定向至 /cookbook/intro。
-
配套改动：无。此 PR 不涉及测试、部署脚本或其他源码文件的修改。
关键源码片段
docs_new/docs.json
这是 Mintlify 文档站点的核心配置文件，定义了站点名称、主题、SEO 设置和重定向规则。本次变更在此文件添加重定向，是解决问题的唯一入口。
{
"$schema": "https://mintlify.com/docs.json",
"theme": "aspen",
"name": "SGLang Documentation",
// ... 其他配置项 ...
"redirects": [
// 已有的重定向规则 ...
{
"source": "/docs/references/learn_more",
"destination": "/"
},
{
// 新增的重定向规则：解决 /cookbook 错误匹配到 server_arguments 的问题
"source": "/cookbook",
"destination": "/cookbook/intro"
},
{
"source": "/index.html",
"destination": "/"
},
// ... 更多重定向规则
]
}
评论区精华
Review 过程非常简单，仅有一条来自 gemini-code-assist[bot] 的自动评论：
“This pull request updates the documentation configuration in docs_new/docs.json by adding a redirect from /cookbook to /cookbook/intro. I have no feedback to provide.”
这表明变更被自动化工具确认无误，没有引发任何人工的技术讨论或争议。
风险与影响
- 技术风险：极低。仅添加一条新的重定向规则，不会干扰现有规则。配置语法简单，出错可能性小。
- 性能与安全：无影响。重定向由静态配置驱动，不涉及运行时计算或安全边界。
- 兼容性：无影响。仅针对文档站点前端路由。
- 影响范围：直接影响访问文档站点
/cookbook 路径的用户体验，确保他们能到达正确的介绍页面。对 SGLang 核心系统、API 或服务逻辑无任何影响。
关联脉络
从近期历史 PR 看，文档站点的重定向和配置维护是一个持续的活动：
- PR #23312 和 PR #23337 同样修改了
docs_new/docs.json 文件，涉及重定向配置的生成和同步。本次 PR 可以视为这一系列文档基础设施维护工作的延续，专注于修复一个特定的 URL 解析问题。
- 这些 PR 共同反映了团队对文档站点用户体验和内容可发现性的持续关注。
参与讨论