| RFC-0067:对 Fuchsia RFC 流程的补充 | |
|---|---|
| 状态 | 已接受 |
| 区域 |
|
| 说明 | 引入“最后调用”步骤;明确退出条件;添加了用于修改 RFC 的流程。 |
| Gerrit 更改 | |
| 作者 | |
| 审核人 | |
| 提交日期(年-月-日) | 2020-12-14 |
| 审核日期(年-月-日) | 2020-02-17 |
摘要
此 RFC 建议对 RFC-0001 中详细介绍的 Fuchsia RFC 流程进行一些补充。引入了“最后一次通话”步骤,取代了“批准”步骤。系统会列出流程中每个步骤的退出条件。 介绍了修改 RFC 的流程。
设计初衷
这些变更的目的是为了解决收到的有关该流程的反馈,并明确进行一些澄清。
在 RFC 的迭代趋于收敛时,“最后一次征求意见”步骤要求工程委员会成员向 eng-council-discuss@fuchsia.dev 发送电子邮件。引入此步骤旨在扩大 RFC 的覆盖面,通过发送推送式通知来征求任何其他反馈,然后再做出最终决定。
明确列出流程中每个步骤的退出条件,旨在总结和阐明该步骤的预期结果。
此外,在“迭代”步骤结束时,工程委员会需要确认相关方,并根据需要进行任何更改。这是为了确保利益相关者名单完整无缺,并在进入流程的下一阶段之前咨询过他们。
实现
针对 RFC 流程的每个步骤提出的更改
社交
此处没有建议的更改。添加以下退出条件。
退出条件:无具体条件。这取决于作者的自行决定。 此步骤旨在帮助作者明确目标和潜在解决方案。如果他们认为已完成此步骤,则可以继续执行下一步。
草稿
为此步骤添加了以下退出条件。
退出条件:包含您的 RFC 的 CL 已创建。
迭代
此步骤新增了以下内容:作者在流程早期征求更广泛的反馈意见,以及让工程委员会验证最终的利益相关者名单。以下文本将添加到 RFC 流程中:
“此外,您还可以通过电子邮件将 CL 发送至 eng-council-discuss@fuchsia.dev,征求更多反馈。”
"在此步骤结束时,请向 eng-council@fuchsia.dev 提供利益相关方及其角色的列表。工程委员会将确认所确定的利益相关方,并根据需要提出任何更改建议。与新确定的任何利益相关者进行迭代。”
除了上述内容之外,我们还将添加以下注释,以帮助审核者撰写反馈:
“致审核者:RFC 流程旨在鼓励各种观点和热烈的讨论。通常,在公开论坛中提供负面反馈可能很困难。如有需要,审核者可以向其主管、同级人员或工程委员会寻求帮助,以便他们制定反馈,从而在 CL 中有效地传达反馈意见。”
退出条件:所有利益相关者均已确定并获得工程委员会批准;已征求并纳入反馈。
最后一次点单
“审批”步骤将更名为“最后期限”。此处的额外步骤是让工程委员会成员在就 RFC 做出决定之前征求任何最终反馈。以下文本将添加到此步骤中:
“一旦 RFC 的迭代趋于收敛,作者必须发送电子邮件至 eng-council@fuchsia.dev,请求将 RFC 的状态更改为最后一次征求意见。 工程委员会成员将向所有利益相关者和 eng-council-discuss@fuchsia.dev 发送电子邮件,征求任何最终反馈,然后再进入决策步骤。此 RFC 将在接下来的 7 个日历日内接受反馈。”
退出条件:所有利益相关方都提供了反馈;所有反馈都已得到解决。
提交
如果已获批准的 RFC 中存在异议,则必须将相应的理由和做出的任何权衡纳入 RFC 中。以下文字将添加到此部分:
如果已获批准的 RFC 中存在异议,则在清除标志后,工程委员会成员会指明是否需要在 RFC 中记录任何其他信息。为此,系统会将以下文本添加到此部分:
“工程委员会将指明您的 RFC 中是否需要记录任何其他信息,例如不同方法的理由或所做的权衡。”
被拒绝的 RFC 将分配下一个可用的 RFC 编号。有效文本将更改如下:
“如果项目决定拒绝您的 RFC,工程委员会的成员会在您的 CL 中添加评论,说明 RFC 已被拒绝,并提供拒绝理由,还会为 RFC 分配一个编号。”
退出条件:已分配 RFC 编号;已纳入任何适用的理由、权衡和工程委员会反馈;RFC 已合并。
修改 RFC 的流程
如果满足以下条件,则可以修改现有 RFC:
- 澄清了已获批准的内容。
- 机械性修订,例如更新链接、文档、使用情况等。
- 稍后(例如在实现期间)发现的任何设计改进或细微更改。
对于设计方面的变更,请记录原始设计目标是什么,以及变更的原因和方式。
如果设计有任何重大变更,请提交新的 RFC。
- 在新 RFC 中,请引用原始 RFC,并在标题中明确指出更改类型,例如:附录。
- 如果原始 RFC 中的设计已被弃用,请修改原始 RFC 以指出这一点并引用新的 RFC。
- 如果有多项 RFC 对同一领域进行了更改,请创建一项新的 RFC 来汇总现有 RFC。另请修改现有 RFC 以引用新的 RFC。
如果 RFC 流程正在更新,请同时更新 RFC 流程页面。
缺点、替代方案和未知因素
缺点:在“最后一次征求意见”步骤中,虽然我们已向 eng-council-discuss@ 引入推送式通知,但我们仍有可能在 7 个日历日内错过接收反馈。这是为了确保 RFC 不会长时间处于开放状态而做出的权衡。
未知事项:随着 RFC 流程的使用越来越广泛,该流程将不断发展。