不是问接口文档,是“当时为什么非要这么写”这种东西。
我们现在有四个地方:Confluence、仓库里的 ADR、群公告、工单评论。结果就是知道有记录,但不知道去哪找。每件事都写 ADR 也试过,很快变成没人看的作文。
目前我只想先解决一件事:两年后改代码的人,能顺着代码找到当年的限制。大家有真用了两三年还没散掉的办法吗?最好别再推荐新平台了。
不是问接口文档,是“当时为什么非要这么写”这种东西。
我们现在有四个地方:Confluence、仓库里的 ADR、群公告、工单评论。结果就是知道有记录,但不知道去哪找。每件事都写 ADR 也试过,很快变成没人看的作文。
目前我只想先解决一件事:两年后改代码的人,能顺着代码找到当年的限制。大家有真用了两三年还没散掉的办法吗?最好别再推荐新平台了。
我们最后放在代码仓库里,文件很丑,但跟着分支和权限走。最大好处不是格式,而是改代码的人顺手就能看到。