「官方文档比外面的课清楚」。
例子能跑。我把目录里最有用的两章标出来了。
先留现场,再动手。把当时的输入、输出、配置名抄下来,确认同一条路径还能再出现一次。不能再出现的现象,改完也不知道是不是改对了。确认之后只改一处。改两处的话,结果变了也分不清是哪一处。改完用同一组输入再走,结果要变成预期的那样,而不是仅仅没有报错。
先写清个人或内部使用时怎么拿到、怎么用、用完怎么停。授权和适用方式放在链接旁边,用之前看一眼。练手不要用真实用户的数据。实验用的环境在名字里写明,用完就删。够用就停,不把一篇推荐写成采购清单。
判断分两层。第一层是现象:什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后,改动尽量小,并写明怎样一分钟内确认它生效。确认不了的改动先不要合。
复查「官方文档比外面的课清楚」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。推荐只写个人或内部怎样用起来,不写采购建议。说清楚怎么拿到、怎么用、用完怎么停。授权放在链接旁边,用之前看一眼,尤其是要拿去演示或分发的时候。练手用公开数据,不用真实用户的数据。实验环境在名字里写明实验,用完就删。小图可以先放仓库,大了再换地方。证书自动续,不手点。够用就停。一篇推荐如果不能让另一个人在不询问作者的情况下用起来并停掉,就还没写完。
操作顺序。1. 写个人或内部怎样拿到,要不要注册。2. 写一条最小用法,输入和输出是什么。3. 写用完如何停,实验环境如何删除。4. 把授权页面的结论用一句话写在链接旁,用之前能看见。5. 练手数据用公开样本,不使用真实用户数据。6. 环境名字里带上实验,避免忘在那里。7. 让另一个人只看这几行独立用一次并停掉。他做不到,就补行,不在聊天里解释。够用就停,不把推荐写成采购清单。