不写“升级了XX库到v3.2”,写“替换了Log4j为SLF4J,因原版本存在JNDI注入漏洞,已验证所有日志输出格式一致,监控告警规则无需调整”。每项升级带原因、验证动作、影响确认三件事。旧版本问题要写实,新版本适配要写细,别让接手的人再花三天查兼容性。