在 Zephyr 项目中,Pull Request (PR) 的标签设置和审查流程是结构化的,旨在确保代码变更得到适当的关注和审查。项目使用标签系统来对 PR 进行分类,并据此确定最小的审查时间要求。
**PR 标签分类与变更类型对应:**
PR 的标签用于指示变更的性质,这直接影响了审查的深度和所需的时间。资料中定义了以下几类标签,它们对应了不同的变更类型和审查要求:
1. **Hotfix (热修复):** 适用于修复阻止开发者日常工作的问题,例如 CI 破坏、测试破坏或影响用户体验的轻微文档修复。这类修复在通过 CI 检查后,可以根据修复的性质、严重程度以及是否有其他可供审查人员,在有理由的情况下,无需项目所有者(project owner)的审查即可合并。
2. **Trivial (微小/琐碎):** 指那些明显且不需要维护者或代码所有者参与的更改。这类更改不应改变子系统或组件的逻辑或设计,例如文档更改、配置更改、轻微的构建系统调整、不改变逻辑的微小代码优化、测试更改和修复,或用于支持额外配置或板卡的样本修改。
3. **Maintainer (维护者):** 任何触及子系统或组件逻辑或原始设计的更改,都需要由代码所有者或指定的子系统维护者进行审查。如果代码更改的发起者不是所有者,PR 需要分配给代码所有者,由其推动 PR 到可合并状态。
4. **Security Review (安全审查):** 针对对系统整体安全有影响的更改,需要由安全工作组的专家进行审查。
5. **TSC 和工作组 (TSC and Working Groups):** 引入新功能、新功能或改变系统整体工作方式的更改,需要由 TSC 或负责的工作组进行审查。例如,API 的破坏性更改(breaking API changes)的提案需要在架构会议上进行展示。
**审查时间要求与流程:**
项目强调,由于全球化的开发团队,必须允许一个最小的审查时间窗口,以便开发者和贡献者有时间进行审查和评论。PR 的分类(通过标签)决定了其所需的审查时间。**更改不应在最小时间过期前被合并。**
**其他关键流程点:**
* **合并要求:** 一个 PR 必须至少获得 **2 个积极的审查(approval)** 才能合并。合并人(merging)与批准人(approval)是不同的角色。
* **标签的确定:** 更改的作者可以在 PR 中建议其所属的类别,但项目维护者或 TSC 成员可以通过添加评论来更改标签,并需提供理由。
* **标签系统:** 项目使用标签系统来分类 PR,标签包括了上述的变更类型标签,以及其他如 `area: {area-name}`(指示受影响的子系统)、`platform: {platform-name}`(指示受影响的平台)等。
总结来说,开发者需要根据变更的性质(是热修复、微小调整、还是核心逻辑修改)来选择或建议相应的标签,从而确保 PR 遵循了项目设定的最小审查时间要求,并由相应的专家或所有者进行充分的审查。