「安全更新建议这周看」。
不是吓人和紧急,是值得排进这周。发行说明写了影响范围。
先留现场,再动手。把当时的输入、输出、配置名抄下来,确认同一条路径还能再出现一次。不能再出现的现象,改完也不知道是不是改对了。确认之后只改一处。改两处的话,结果变了也分不清是哪一处。改完用同一组输入再走,结果要变成预期的那样,而不是仅仅没有报错。
动态只记会影响我们怎么用的那一部分:默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级前先搜自己有没有依赖旧行为。不紧急的排进周或季度,不要在维护窗口里发布。
判断分两层。第一层是现象:什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后,改动尽量小,并写明怎样一分钟内确认它生效。确认不了的改动先不要合。
复查「安全更新建议这周看」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。只写会影响我们怎么用的变化。默认值变了,就搜自己的配置有没有依赖旧值。接口弃用了,就写替代和截止日期,新代码从现在停用旧的。协议变了,就按现在的用法重读,不用去年的印象。维护窗口写进日历,那段时间不发布。安全更新读影响范围,再决定是这周还是当天。示例仓库更新后,旧克隆会和文档对不上,要写明重新拉还是看差异。一篇动态如果不能回答‘我们要不要改、什么时候改’,就还是公告,不是记录。
操作顺序。1. 只摘会改变我们用法的点:默认值、弃用、协议、维护窗口、安全影响。2. 写我们要不要改,以及这周、本月还是下个季度。3. 升级前搜索自己是否依赖旧行为。4. 维护窗口写进日历,那段时间不发布。5. 示例或文档地址变了,就写明旧链接还会跳转多久。6. 把结论压成三行放在开头,细节放后面。读完三行仍不知道要不要行动,这篇就还是转载,不是我们自己的记录。