「提请求前读贡献说明」。
他们要测试和一种提交格式。按着做,来回少了一轮。
判断分两层。第一层是现象:什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后,改动尽量小,并写明怎样一分钟内确认它生效。确认不了的改动先不要合。
用进项目之前看三件事:最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套,通常不划算。大版本先读迁移说明,在分支上试。锁文件要提交。给上游提修改时按他们的格式来。选它的理由写下来,几个月后会忘记。
先留现场,再动手。把当时的输入、输出、配置名抄下来,确认同一条路径还能再出现一次。不能再出现的现象,改完也不知道是不是改对了。确认之后只改一处。改两处的话,结果变了也分不清是哪一处。改完用同一组输入再走,结果要变成预期的那样,而不是仅仅没有报错。
复查「提请求前读贡献说明」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。引进之前写三行:最后一次提交是什么时候,协议允不允许我们这样用,讨论区是不是反复同一个安装坑。三行有任何一行过不了,就先不要引进。只为了一个小功能而背上整套概念,后面会在升级和安全更新上还债。大版本单独开分支,按迁移说明试,默认值可能和以前相反。锁文件和代码一起提交,保证别人装到同一版。给上游提修改时先读他们的贡献说明,格式和测试按他们的来。选它而不选另一个的理由写在仓库里,几个月后没人记得。
操作顺序。1. 看最后一次提交日期和未关闭的讨论。2. 读协议,确认我们的用法在范围内。3. 只取需要的功能,关掉其余默认项。4. 大版本先在分支按迁移说明试,不直接升。5. 锁文件和代码一起提交,并用干净目录安装一次。6. 要改上游就先读贡献说明,按他们的测试和格式提交。7. 在仓库写三行:为什么选它、什么时候再评估、谁负责升级。没有这三行,半年后没人敢动它,也没人敢换掉它。