执行摘要

本 PR 将 SGLang 文档从独立仓库迁移至主仓库的 docs_new/ 目录，新增基于 Mintlify 的文档站点，涵盖入门指南、模型文档、硬件平台等，旨在统一文档来源并简化维护。变更仅限于文档，不影响代码，风险较低但需注意链接和渲染问题。

功能与动机

动机：为了解决跨仓库文档同步的维护开销，PR 将 sgl-docs 和 sgl-cookbook 的内容迁移到主仓库，形成单一真实来源。这样，用户和开发者可以更方便地访问和更新文档，同时利用 Mintlify 提供现代化体验。

实现拆解

1. 入口变更：在仓库根目录添加 docs_new/ 目录，作为新文档站点的根路径。关键配置文件 docs_new/docs.json 定义了导航结构，将内容分为 Docs 和 Cookbook 两大板块。
2. 核心逻辑与数据结构：文档站点包含交互式组件，例如在 docs_new/src/snippets/autoregressive/ 下的 JSX 文件。这些组件采用 React 实现，通过配置数据和用户输入动态生成部署命令。以下以 deepseek-r1-advanced-deployment.jsx 为例展示核心函数：

// DeepSeekR1AdvancedDeployment 组件：交互式部署命令生成器
export const DeepSeekR1AdvancedDeployment = () => {
  // 配置数据，硬编码硬件、量化等选项，支持动态匹配
  const lookupData = {
    model: "deepseek-r1",
    version: "v0.5.6",
    ui_options: {
      hardware: [
        { id: "b200", label: "B200", default: true },
        { id: "h200", label: "H200", default: false }
      ],
      quantization: [
        { id: "fp8", label: "FP8", default: true },
        { id: "fp4", label: "FP4", default: false }
      ]
    },
    configs: [
      {
        hardware: "b200",
        quantization: "fp4",
        gpu_count: 4,
        scenario: "low-latency",
        parameters: {
          model_path: "nvidia/DeepSeek-R1-0528-FP4-v2",
          tensor_parallel_size: 4,
          cuda_graph_max_bs: 256
        }
      }
    ]
  };
​
  // 关键函数：根据用户选择查找匹配配置
  const findConfig = (hardware, quantization, gpuCount, scenario) => {
    return lookupData.configs.find(
      (config) =>
        config.hardware === hardware &&
        config.quantization === quantization &&
        config.gpu_count === gpuCount &&
        config.scenario === scenario
    );
  };
​
  // 关键函数：从配置生成部署命令，拼接 SGLang 启动参数
  const generateCommandFromConfig = (config) => {
    const params = config.parameters;
    let command = `python3 -m sglang.launch_server \\\n`;
    command += `  --model-path ${params.model_path}`;
    if (params.tensor_parallel_size) {
      command += ` \\
  --tp ${params.tensor_parallel_size}`;
    }
    // 根据其他参数（如 kv_cache_dtype）扩展命令
    return command;
  };
​
  // 组件使用 React 状态管理用户输入，并渲染命令
  const [values, setValues] = useState({ hardware: "b200", quantization: "fp8", gpu_count: 8, scenario: "low-latency" });
  const selectedConfig = findConfig(values.hardware, values.quantization, values.gpu_count, values.scenario);
  const command = selectedConfig ? generateCommandFromConfig(selectedConfig) : "";
​
  return (
    <div>
      {/* UI 元素省略 */}
      <pre>{command}</pre>
    </div>
  );
};

3. 文档内容迁移：将原有文档分类放入 docs_new/docs/（如 Getting Started、User Guide）和 docs_new/cookbook/（如模型示例、基准测试），覆盖 LLM、VLM、Diffusion 等模型，以及 NVIDIA、AMD、NPU 等硬件平台。
4. CI 配套：添加 GitHub Actions 工作流（如 .github/workflows/ 中的文件），定期从 LMSYS 仓库同步博客卡片，保持文档新鲜度。
5. 无代码或测试改动：所有变更都位于 docs_new/ 下，不涉及源代码、测试或配置文件，因此无需额外测试覆盖。

评论区精华

review 讨论非常简短，仅涉及文档细节修复：

• zijiexia 指出一个 broken link 和两个警告信息渲染问题，并提供了具体修复建议。
• 所有建议均被采纳，无技术争议或设计权衡讨论，体现了文档 PR 的协作模式。

风险与影响

风险：

• 链接错误：迁移过程中可能遗漏或错误链接，需人工检查或自动化验证。
• 渲染问题：Mintlify 主题或自定义组件可能导致内容显示异常，如 review 中提到的警告格式。
• 内容过时：文档与代码实际行为可能逐渐脱节，建议建立定期更新机制。

影响：

• 用户：获得统一、交互式的文档站点，提升学习和部署效率。
• 系统：零影响，纯文档变更不改变运行时行为。
• 团队：简化维护，但需适应新目录结构，并可能增加初期的文档校对负担。

关联脉络

从历史 PR 看，近期多有文档和 CI 相关更新（如 #23287、#23279），但本 PR 是首次大规模文档迁移，标志着文档集中化管理的开始。未来可能围绕 docs_new/ 进行更多文档优化或国际化扩展。