什么是 活文档(Living Documentation)?
活文档由 Cyrille Martraire 提出,拒绝接受「文档注定会腐化」这一前提。其理念是:把文档当作代码库的产物(提取、生成或持续校验),而不是一份需要有人记得去更新的平行产物。从代码中发现的 C4 模型,以及在 CI 中强制执行的一致性规则,都是这一理念的实例。
相关术语
- 架构即代码(Architecture as Code) — 用受版本管理的文本格式描述系统架构,使其能像源代码一样被评审、比对和验证。
- 架构漂移(Architecture Drift) — 文档中的架构与生产环境中实际运行的系统之间日益扩大的差距。
- MCP 服务器(MCP Server) — 一个实现了 Model Context Protocol 的服务器,让 AI 编码助手能通过标准化的工具接口查询项目上下文。