新的长期支持版本有日期了

「新的长期支持版本有日期了」。

团队可以排进下个季度,不必这周就动。

这次按时间写。先发生什么,中间查了什么,最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开,避免第二天把猜测当成事实。验证用的是改之前的同一条路径,不是换一组更容易过的输入。

动态只记会影响我们怎么用的那一部分:默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级前先搜自己有没有依赖旧行为。不紧急的排进周或季度,不要在维护窗口里发布。

记录里保留失败的那一次。只写成功,别人学不到边界。失败时的输出、当时的配置、本来期望发生什么,三样放在一起。修好之后补一句:如果再出现,先看哪一行。没有这句,这篇就只是故事。

复查「新的长期支持版本有日期了」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。只写会影响我们怎么用的变化。默认值变了,就搜自己的配置有没有依赖旧值。接口弃用了,就写替代和截止日期,新代码从现在停用旧的。协议变了,就按现在的用法重读,不用去年的印象。维护窗口写进日历,那段时间不发布。安全更新读影响范围,再决定是这周还是当天。示例仓库更新后,旧克隆会和文档对不上,要写明重新拉还是看差异。一篇动态如果不能回答‘我们要不要改、什么时候改’,就还是公告,不是记录。

操作顺序。1. 只摘会改变我们用法的点:默认值、弃用、协议、维护窗口、安全影响。2. 写我们要不要改,以及这周、本月还是下个季度。3. 升级前搜索自己是否依赖旧行为。4. 维护窗口写进日历,那段时间不发布。5. 示例或文档地址变了,就写明旧链接还会跳转多久。6. 把结论压成三行放在开头,细节放后面。读完三行仍不知道要不要行动,这篇就还是转载,不是我们自己的记录。

4 个赞

长期支持版本排进季度计划就好。不必这周升级。

2 个赞