「对比两份配置」。
用差异查看,别并排肉眼找。差一个字符也能看见。
这次按时间写。先发生什么,中间查了什么,最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开,避免第二天把猜测当成事实。验证用的是改之前的同一条路径,不是换一组更容易过的输入。
工具够用就行,不比谁的套件全。选的时候看它能不能把一件重复的事变短,以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单,确认后再执行。
记录里保留失败的那一次。只写成功,别人学不到边界。失败时的输出、当时的配置、本来期望发生什么,三样放在一起。修好之后补一句:如果再出现,先看哪一行。没有这句,这篇就只是故事。
复查「对比两份配置」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。介绍工具时写它缩短了哪一件具体的事,不写功能清单。本地、测试、生产的地址和账号分开存,避免拿测试地址去打生产。批量修改先打印将要改的名单,确认后再执行。图和脚本除了导出结果,也把源文件放进仓库,以后改不用重画。日志至少能按请求编号过滤,这一步做到了再考虑更重的平台。选择标准是:一个人离开后,另一个人能不能按仓库里的三行说明继续用。不能,就还没介绍完。
操作顺序。1. 写清这个工具缩短的那一件事,以及不用它时要手工做哪几步。2. 本地、测试、生产的地址分开保存。3. 批量操作先列出名单,确认后再执行。4. 把用法写成三行放进仓库:何时用、一条例子、失败看哪里。5. 源文件和导出结果一起留,避免下次重画。6. 让另一个人按这三行独立用一次。他要提问,就把答案写回这三行。工具介绍如果离不开作者口头补充,就还不能算分享完成。