Prhub

#27766 [Docs] Remove the legacy release-docs.yml deploy workflow

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

执行摘要

删除已废弃的文档部署工作流

docs.sglang.io 已切换到 Mintlify(DNS 指向 cname.mintlify-dns.com),旧的 Sphinx 工作流仍在每次 push 到 main 时触发,消耗 GPU runner(约 12-15 分钟),且产物不再用于生产。PR 描述中明确指出:"the workflow is now vestigial: it burns a GPU runner per merge to keep a site nothing canonical points to."

无需精读。这是一个简单的清理 PR,可以快速批准。但对于关注 CI 成本优化和文档基础设施的团队,值得了解其背景。

讨论亮点

无实质性讨论。只有 ispobock 批准了 PR,无 review 评论。

实现拆解

  1. 删除工作流文件:移除 .github/workflows/release-docs.yml,该文件包含 89 行定义,涉及文档构建、Jupyter notebook 执行、HTML 生成以及推送到 sgl-project.github.io 仓库的步骤。
  2. 文档迁移计划的一部分:此删除对应 docs_new/docs_migration_plan.md 中的 Phase 6, step 4("Remove or archive old resources"),前提条件(DNS 切到 Mintlify)已经满足。
  3. 未包含的清理项docs/README.md 中仍有引用该工作流的说明,但仓库的 check-no-docs-changes hook 禁止编辑遗留 docs/,该部分将在后续删除整个 docs/ 时处理。sgl-project/sgl-project.github.io 仓库的归档也是独立的可选步骤。
文件 模块 状态 重要度
.github/workflows/release-docs.yml CI 工作流 removed 5.57

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

评论区精华

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

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

风险与影响

低风险。完全删除一个已废弃的工作流,不涉及任何业务逻辑或运行时行为变更。需确认没有其他流程依赖该工作流的输出(例如,有文档团队是否还引用 sgl-project.github.io 仓库)。

  • CI 资源:每次 push 到 main 节省约 12-15 分钟 GPU runner 时间。
  • 文档站点:无影响,因为生产站点已使用 Mintlify。
  • 团队:开发者不再需要关心旧文档构建。
  • 回滚:如果出现问题,可以轻松恢复该文件。
无实质风险

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论