用途:从指定时间段内 docker/docs 仓库已合并的文档 PR 中,挑选真正值得主动告知用户的 Docker 发布亮点,生成或维护 data/whats-new.json。文档合并仅作为功能已发布的证据,文档改动本身不算新闻。
入选标准:需同时满足——该周期前不可用的面向用户的新功能、重要增强或更广泛可用里程碑;属于实质性能力或工作流,而非新语法或既有流程中的小控件;具备跨 Docker 的编辑价值,值得在产品发布说明之外主动告知;有可用的已发布页面及事实性标题与描述。标准从严,结果是精选发布档案而非完整变更日志;冷清周期可能没有或极少条目。
排除项:文档维护、修复、重写、旧行为说明、例行发布或生成内容同步、限制与前置条件及变通方法、狭窄的开关/设置/命令变体/协议/兼容性变更、渐进式 UI/安全/权限/可观测性改进,以及底层 Engine、Build、网络或存储变更;除非它们属于独立值得报道的产品级发布。判断依据是用户结果,而非 PR 大小、产品热度、标签、改动行数、是否有专页或新 API/命令。
亮点:收录所有合格发布,不设配额;将最重要的五个标记 featured: true,不足五个则全部标记。按用户结果的重要性和独特性排序。同一发布合并为一个条目并合并相关 PR;保留仍准确且合格的既有文案。
流程:读取 data/whats-new.json;未指定发布窗口时,以之前一个 UTC 日为结束、向前 29 天为开始。增量审查列出检查点次日到窗口结束的合并 PR,保留窗口内既有条目;未提供检查点则用现有 period_end。全量审查检查窗口内所有 PR。命令:$ gh pr list --repo docker/docs --state merged --search 'merged:START..END' --limit 200。增量搜索无结果时跳过候选检查,仅移除过期条目。检查每个候选的 diff 与结果页面,仅凭合并文档证据判断。移除窗口前发布的条目,新增合格发布,合并相关 PR,重新评估 featured。更新 period_start、period_end 和 items,按发布日期倒序。
报告:按产品、标题和来源 PR 列出新入选条目;按数量汇总保留与过期条目,指出内容或来源变化的保留条目;只解释最相关的合理排除项。若需创建 PR,用同一报告作为 PR 正文,含 ## Summary、## Selected entries、## Curation notes,每条目一个 Markdown 项目符号,PR 引用写作 #NNNN,不硬换行,不创建 .pr-body.md 等交接文件。
条目字段:product、title、description、url、published、source_prs、featured;使用规范产品名、已发布的内部 URL、YYYY-MM-DD 合并日期和来源 PR 编号。文案需事实、克制,避免最高级、宣传性语言及关于易用性或重要性的断言。除 data/whats-new.json 外不得修改受跟踪文件。