序列图画得轻一点

「序列图画得轻一点」。

方块和箭头就够讨论。画完把原文件放进仓库,别只留导出的图。

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

工具够用就行,不比谁的套件全。选的时候看它能不能把一件重复的事变短,以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单,确认后再执行。

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

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

补充记录。介绍工具时写它缩短了哪一件具体的事,不写功能清单。本地、测试、生产的地址和账号分开存,避免拿测试地址去打生产。批量修改先打印将要改的名单,确认后再执行。图和脚本除了导出结果,也把源文件放进仓库,以后改不用重画。日志至少能按请求编号过滤,这一步做到了再考虑更重的平台。选择标准是:一个人离开后,另一个人能不能按仓库里的三行说明继续用。不能,就还没介绍完。

操作顺序。1. 写清这个工具缩短的那一件事,以及不用它时要手工做哪几步。2. 本地、测试、生产的地址分开保存。3. 批量操作先列出名单,确认后再执行。4. 把用法写成三行放进仓库:何时用、一条例子、失败看哪里。5. 源文件和导出结果一起留,避免下次重画。6. 让另一个人按这三行独立用一次。他要提问,就把答案写回这三行。工具介绍如果离不开作者口头补充,就还不能算分享完成。

5 个赞

图导出之后,把源文件也放进仓库。以后改箭头不用重画。

3 个赞