RFC 执行账本¶
每条一个文件。一条账本条目记录某次改动测到了什么、改了什么、以及明确没有确立 什么——就是过去追加到 RFC 附录 A 的那些内容。
为什么条目是文件¶
附录 A 是一个共享的追加簇。每个新增条目的分支都插在同一个位置,所以并发工作在 那里必然冲突:#4447 的修复轮里一个下午撞了八次,每次的解法都是"两侧不相交、 保留双方"。这是机械劳动,而且有真实的失败模式——一次粗心的解决就会静默丢掉一条 记录。
一条一个文件消除了这行共享。同一天新增条目的两个分支碰的是两个不同文件,无需 任何解决即可干净合并。
约定¶
<rfc-slug>/YYYY-MM-DD-slug.md—— 每份 RFC 一个目录,目录名与其所属 RFC 文件名完全一致。多份 RFC 带执行账本附录,所以条目必须写明它补的是哪一份。 RFC 内那一节的标题是附录 <字母>:执行账本,用该 RFC 还没占用的字母。- 文件名中的日期是测量当天,不是合并当天。
- 每条配一份中文镜像
<rfc-slug>/YYYY-MM-DD-slug.zh-CN.md,与 RFC 自身同一规则。 - 每个 RFC 的目录就是该 RFC 的索引。跨 RFC 不设枚举,因为索引行正是本目录要消除的那种 追加簇。
- 条目是只追加的历史。要更正一条写错的条目,用后续条目说明错在哪;不要重写别人 可能已经引用过的记录。
命名与镜像配对由 examples/docs-governance-smoke.py 校验。