越来越觉得,写那些发布后很快就会过时的文档已经没什么意义了。
因为一旦发布,就意味着它需要被维护和真相的一致性。而这非常的消耗成本,因为总有不一致会产生。
可以说,code base 才是一切真相的来源。
其实一直也都是,你过去应该会碰到过有产品经理不知道最新的业务逻辑需要从代码中找真相的情况(需求文档不一致、有人离职交接不完善等原因)。
尤其有了强大的 coding agent 后,我们可以随时按需求给出真相的各种视图。
虽然考虑到可见范围,在一些对外的场景上暂时还需要文档。但基本可以说,软件工程中的文档已经没有太多存在的必要了。
更需要维护好的是:代码。