配置里哪些能动

「配置里哪些能动」。

标注过的可以改。没标注的先别动。改之前复制一份旧的。

给后来的人看,所以写能照着做的步骤,不写感受。每一步写期望看到什么。看不到,就停在这一步,不要继续往下猜。步骤结束以后,用干净环境再做一次。自己的机器上能过,只能说明自己的机器上能过。

这篇按可以照着做的顺序写。每一步都写期望看到什么,不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里,不放在聊天记录里。给别人之前,在干净目录自己走一遍。

收尾只留三行在仓库里:现象,改了哪一处,怎样确认。聊天记录会沉,仓库还在。三行对不上,就还没完,先不要告诉别人已经好了。对得上,别人才能在不找作者的情况下把同一件事再做一遍。

复查「配置里哪些能动」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。步骤按别人能跟着做来写。每一步只有一个动作,并写明做完应该看到什么。看不到就停,不要写‘然后应该就可以了’。开始前列出需要的运行时和配置样例,样例用假值。结束前在干净目录自己走一遍,走不通就改步骤,不增加口头补充。出错时要求留下三样:完整输出、当时的配置、期望结果。说明放在仓库,不放在聊天。第一周的目标只到能跑、能提交、知道去哪问,不要把整套结构塞进第一篇。

操作顺序。1. 写明给谁看,以及做完他能做什么。2. 列出运行时和一份用假值填好的配置样例。3. 每步只有一个动作,并写期望看到的输出。看不到就停在这一步。4. 在干净目录自己走完全程。5. 把走不通的地方改步骤,而不是在聊天里补一句。6. 出错时要求留下完整输出、配置和期望。7. 说明随代码放进仓库。第一周只要求能跑起来、能提交、知道去哪问,不把整套结构放进第一步。

5 个赞

没标注的配置先别动。要改就先复制旧文件。

3 个赞