「提交说明写为什么」。
改了什么,差异里看得到。为什么改,只有说明里有。
先留现场,再动手。把当时的输入、输出、配置名抄下来,确认同一条路径还能再出现一次。不能再出现的现象,改完也不知道是不是改对了。确认之后只改一处。改两处的话,结果变了也分不清是哪一处。改完用同一组输入再走,结果要变成预期的那样,而不是仅仅没有报错。
评审先看行为对不对,格式可以后改。提交说明写为什么,差异里已经看得到改了什么。主干当天要能发布,不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写下来,不放在心里。
判断分两层。第一层是现象:什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后,改动尽量小,并写明怎样一分钟内确认它生效。确认不了的改动先不要合。
复查「提交说明写为什么」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。评审先看行为,格式后面再说。提交说明写为什么,差异里已经有改了什么。主干当天要能发布,坏了当天修或当天撤。不能独自回滚的变更,不安排在只有一个人值班的时候。长期分支不如开关。告警只留需要人起来的那几条。新人第一周只做到能跑、能问、能提交。时间和范围写成区间,并写明不做什么。决定和欠下的债用一段话放进仓库。不写下来,两个月后会再吵一次,债也会变成脾气。
操作顺序。1. 评审先看行为是否符合预期,格式随后。2. 提交说明写为什么改,差异里只看得到改了什么。3. 合入主干前确认当天能发布,不能发布就不要合。4. 不能独自回滚的变更,避开单人值班。5. 告警删到只剩需要人处理的几条。6. 新人第一周的完成标准写成能跑、能问、能提交。7. 范围用三行写清不做什么。8. 决定和欠下的债各用一段话放进仓库。少了第 8 步,两个月后讨论会从零开始,债也会变成口头上的不耐烦。