大伙怎么维护代码流程之类的文档,讨论讨论

查看 24|回复 2
作者:Chuckle   
一个动作入口背后可能经过 n 个函数,分散在不同文件、不同包里,产生 n 个动作分支,经过多年迭代后这颗饱含业务与代码的逻辑树就很难看懂了。
但在写代码外还要写 markdown 、画图,感觉是难以为继的事,需要每个维护者都遵守规则去写文档,这个脆弱的文档很可能在某次小功能迭代、人员变动后就对不上代码,从而无人问津了。越来越大的文档库,也难找到要看的地方。
产品 prd 自然有维护一些业务流程,但和代码实现也是两码事,缺少含有业务语义的代码流程。
还是说没必要维护,全靠脑子记,忘了就从触发入口开始一路再看一遍。
代码当中通常会有起节点作用的重要模块或函数,它们通常是大业务动作下可分解出的小业务动作的入口,那通过注解或者魔法注释,自动标记这些代码位置,在写代码的时候顺手标记下,人为加上业务语义备注,最后自动生成一份流程图,可不可行,现在有没有类似的工具了。
再编写个 vscode 插件,点击这些魔法注释,能够聚焦到流程图对应位置,反之也可以定位到代码位置。

代码流程, 文档维护, 业务语义

Chuckle
OP
  
让 ai 定期扫代码库,生成代码流程图的,代码各个大大小小的函数调用链路倒是清楚,但太细了,ai 自己加的业务理解和业务流程还是有较大偏差,更有些完全幻想出来的流程,毕竟是靠函数、变量名、乱七八糟的注释推理的,作为给人看的东西还是勉强了。
Chuckle
OP
  
另外有没有好用的画图软件,目前用 Draw.io ,有 vsc 插件可以打开.dio 文件是方便,但 Draw.io 各个元素之间太独立了,画好后要在中间某一部分插一点东西,拖动调整起来麻烦。
您需要登录后才可以回帖 登录 | 立即注册

返回顶部