文档负债

你有没有见过一份“要命的”详细设计文档？我见过。三年前我接手过一个项目交接，对方团队交过来一个压缩包，里面有一份187页的详细设计说明书，目录就有6页。光“用户登录模块”就写了14页，包含了20多种异常分支的处理方案、8张时序图、还有一份数据库字段设计，精确到了每个字段的NOT NULL约束都标得清…

一、我从一场沉默的项目复盘会里，看见文档如何“吃掉”了开发 2023年深秋，我被拉去旁听一家百人规模的SaaS公司项目复盘会。项目延期11周，验收时客户翻了脸。所有人都以为是因为核心模块有技术难题，结果复盘出来，全场沉默了将近五分钟。 他们的一位后端负责人推过来一张表格： 需求分析阶段产出文档：21…