| 来源 | 变更不同步、缺模板、无责任人、口头传承 |
|---|---|
| 代价 | 上手变慢、误操作、故障时无据可依 |
| 治理 | 完成定义含文档 + 变更检查 + 定期对账 |
完成定义示例
完成定义示例
☑ 代码合并
☑ 测试通过
☑ 变更说明更新
☑ 受影响的 Runbook 已更新
☑ 监控与告警同步调整文档债
文档债指文档与实际不一致的积累：过期步骤、缺失的变更说明、只在个人脑中的隐性知识；治理方式是随变更同步文档 + 定期对账 + 把文档纳入完成定义。
易错点
- 文档总排到最后：债务累积后补写成本成倍上升
- 重写代替维护：大扫除式重写后很快再次过期
数据来源与参考
- 技术文档管理公开实践（文档债概念）
- Docs as Code 社区讨论