记录升级决策：以后如何知道当时为什么选择这个版本

版本选择常受兼容性、安全性和交付时间共同影响。简短记录能减少人员变动后的信息断层。

记录必要事实

写明当前与目标版本、选择原因、已知风险、验证范围、回退条件和未解决事项即可。

让记录能被复用

将记录链接到发布说明、测试结果和部署变更单，下一次升级时据此更新判断。发布说明到行动的转换方法见怎样读开源项目发布说明。