#14081·dagger

ci: 为每个文档版本保存 API 描述

作者: shykes创建于 2026年9月9日更新于 2026年9月9日

□ 内容

Dagger的文档网站有当前多克并保存了多克为旧版本.

API参考页面在网站建设期间读取了API描述文件. 此文件包含这些页面上显示的 API 类型、 字段和文本 。

□ 问题

所有文件版本都读取了当前 API 描述 。 当当前 API 更改时, 这可以打破更旧的页面 。

例如,第13992号:

  1. 保存的β页提到`ModuleManifestV1'。
  2. 目前的API描述不再包含这种类型。
  3. 该页面无法被构建,因此文档构建在 CI 中失败.

`dagger 生成文件'仅更新当前页面。 它不会修复被保存的β页.

□ 解决

当“docs”模块保存一个docs版本时,也保存其API描述. 两者必须来自相同的Git修订.

在网站构建过程中,每个docs版本必须读取自己保存的API描述. 当前页面继续使用当前描述.

添加现有文档版本的匹配 API 描述作为此修改的一部分 .