自动生成文档

在做了将近十六年的技术写作和开发者工具咨询之后，我越来越确信一个反直觉的结论：绝大多数团队在文档上的投入，本质上不是在创造知识，而是在不断修补腐烂的信息副本。去年冬天，我在给一个拿了B轮的企业服务团队做效能诊断时，翻了他们最近六个月的两百多个Pull Request，发现一个很讽刺的比例：其中68%的README更新是因为新成员入职发现环境搭不起来临时补的，19%的API文档修改是因为联调方在群里…