用途:当人类在工作过程中就某事做出决定时,按此技能把该批准记录到唯一合适的位置,避免同一决定日后被反复重新讨论。它只记录批准,不制造批准;沉默、被点头的叙述、过往类似批准都不算本次批准。
什么算批准:仓库命名权威要求其点头的受限名称;范围裁定,如舍弃某标准、合并切片、拆分新工单;偏离规范、ADR 或工单已有说法的做法;被拒绝的审查项或警告;在两个真实选项中做出选择。拒绝也是批准,同样需要记录,因为它没有落入文件树而最易丢失。
记录位置:放在决定所在的那一处,不要重复记录。改动审查中的批准写入 PR 正文或针对具体审查项的回复;超出单次改动的决定写入 issue;路标决策工单写入其解决评论;一项整体工作而非单个工单写入地图正文的已定决策区;受仓库权威管制的命名写入该权威指定的位置。仓库自身权威优先于上述表格,应先阅读其命名权威与 issue 跟踪文档。应在依赖它的东西落地前记录,例如 PR 合并、工单关闭、地图推进之前。
写什么:四件事,首先是容易被漏掉的批准人姓名;使用绝对日期;一行写明决定本身;写明被否掉的备选方案。从不提交的内容:讨论过程不进入文件树,不作为代码注释、规范中的理由段落、笔记或发现文件,也不作为“我们考虑过什么”章节。文件树保存决定,跟踪器保存由谁决定及为何不选备选。例外只有 ADR 的已考虑备选段落和规范中规范自身结构允许的一行理由。完成标准:本次会话给出的每个批准都恰好记录在一个位置,各自写明谁、何时、什么、备选,且讨论内容未被提交进文件。