ci: 为每个文档版本保存 API 描述
作者: shykes创建于 2026年9月9日更新于 2026年9月9日
□ 内容
Dagger的文档网站有当前多克并保存了多克为旧版本.
API参考页面在网站建设期间读取了API描述文件. 此文件包含这些页面上显示的 API 类型、 字段和文本 。
□ 问题
所有文件版本都读取了当前 API 描述 。 当当前 API 更改时, 这可以打破更旧的页面 。
例如,第13992号:
- 保存的β页提到`ModuleManifestV1'。
- 目前的API描述不再包含这种类型。
- 该页面无法被构建,因此文档构建在 CI 中失败.
`dagger 生成文件'仅更新当前页面。 它不会修复被保存的β页.
□ 解决
当“docs”模块保存一个docs版本时,也保存其API描述. 两者必须来自相同的Git修订.
在网站构建过程中,每个docs版本必须读取自己保存的API描述. 当前页面继续使用当前描述.
添加现有文档版本的匹配 API 描述作为此修改的一部分 .
内容来源: dagger/dagger