Prhub

#35911 chore: bump docs install version to 0.5.18

原始 PR 作者 sglang-bot 合并时间 2026-08-22 04:24 文件变更 2 提交数 1 评论 1 代码增减 +3 / -3

执行摘要

将文档安装版本号从 v0.5.16 同步至 v0.5.18

v0.5.18 版本发布后,官方安装文档仍指引用户 git clone -b v0.5.16,Docker 示例也推荐固定 lmsysorg/sglang:v0.5.16 不可变 tag,会导致新用户按文档安装到过期版本。PR body 表明其目的为 "bumps the docs install version to 0.5.18 across all relevant files",commit message 标注 "🤖 Generated with GitHub Actions",属于发布流程驱动的例行版本同步,无关联 Issue。

无需精读,属机械式文档版本同步。可作为了解 sglang-bot 自动化发布维护机制的样例;若团队维护多页面文档,值得借鉴“版本发布后自动同步文档版本号”的流程,同时注意配合一次全局 grep 校验确保无版本号遗漏。

讨论亮点

PR 无实质技术讨论。维护者 zijiexia 直接批准(APPROVED,无评论)。唯一评论来自 mintlify bot,自动报告文档预览部署状态:"Preview deployment for your docs... 🟢 Ready",并提供预览链接,属自动流程通知而非人工反馈。CI 方面,Base 测试通过,Extra 测试标记为失败,但作为纯文档变更未阻塞合并。

实现拆解

  1. 更新主安装文档 docs/docs/get-started/install.mdx:将源码安装示例的 git clone 分支从 v0.5.16 改为 v0.5.18;同时将 <Note> 提示中推荐固定不可变 Docker tag 的示例从 lmsysorg/sglang:v0.5.16 改为 lmsysorg/sglang:v0.5.18,保证“pin an immutable version tag for reproducible deployments”的示例与最新版本一致。
  2. 更新 AMD 平台指南 docs/docs/hardware-platforms/amd_gpu.mdx:将 git clone 分支从 v0.5.16 改为 v0.5.18,确保 AMD 用户在编译 sgl-kernel 时基于新的发布分支。
  3. 配套动作:无测试、配置或 schema 变更;mintlify bot 自动为 PR 生成文档预览部署(状态 Ready),供审阅者合并前核验渲染效果。
文件 模块 状态 重要度
docs/docs/get-started/install.mdx 安装文档 modified 2.32
docs/docs/hardware-platforms/amd_gpu.mdx 平台文档 modified 1.74

关键源码片段

docs/docs/get-started/install.mdx documentation

SGLang 安装主文档,包含 git clone 分支与 Docker 不可变 tag 示例,是本 PR 的核心改动对象,直接决定新用户安装指引的版本准确性。

# docs/docs/get-started/install.mdx 中的安装命令示例
# 版本号由 bot 从 v0.5.16 同步至 v0.5.18,避免新用户 clone 到旧版本
# 注意:latest 与 dev 是可变 tag,文档建议固定不可变版本 tag 保证可复现部署
git clone -b v0.5.18 https://github.com/sgl-project/sglang.git
cd sglang
​
# Docker 方式部署时,推荐固定不可变 tag,例如:lmsysorg/sglang:v0.5.18

评论区精华

Mintlify 文档预览部署通知 other

mintlify bot 自动为 PR 生成文档预览并报告状态 Ready,提供预览链接(lmsysorg-bot-bump-docs-version-0-5-18-32520522138-1.mintlify.site),属于自动流程通知。

结论:预览可用,无人工讨论;维护者 zijiexia 直接批准合并。 · 已解决

风险与影响

风险极低,仅为两处文档字符串替换,不触及任何运行时逻辑。主要风险点:一是版本号一致性,仓库中可能还有其他文档页面(如其他平台安装页、Docker 部署页、cookbook)仍引用 v0.5.16,本次仅更新 2 个文件,若存在遗漏会导致部分入口继续展示旧版本号,建议后续全局 grep 校验 v0.5.16 是否在 docs 目录清零;二是前提假设 v0.5.18 已正式发布且 Docker Hub 镜像 tag 存在(由发布流程驱动,可信度较高),否则用户按文档拉取镜像会失败。

影响对象为所有阅读 get-started 安装页的新用户,以及按 amd_gpu.mdx 编译 sgl-kernel 的 AMD 用户;影响方向是让安装指引与当前 release 对齐,避免用户安装陈旧版本。影响程度低,不涉及运行时行为、API 或性能。对团队而言,该 PR 展示了 sglang-bot 自动化文档维护机制的运转,是发布流程闭环的一部分。

版本号引用可能遗漏

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论