知识卡片

无法沟通的架构是债务而非资产

普通读书笔记卡 · 2048.a

内容

[[每个系统都有架构无论是否被理解|每个系统都有架构]],但并非每个系统都拥有能有效沟通这份架构的架构描述——文档可能只覆盖了一部分、已经过时,或者根本没人看得懂。如果利益相关者无法通过架构描述理解架构如何满足他们的关注点,这份架构本身就失去了存在的价值:它不再是帮助团队做决策的资产,反而变成了需要靠口口相传、返工和猜测来弥补的债务。写文档不是锦上添花,是让架构真正发挥作用的必要条件。

参考来源

- 位置:第2章《软件架构概念》2.4节「架构描述」(源文件:_epub-src/OEBPS/text00011.html附近) - 结论依据:原文明确指出若架构无法被利益相关者理解或说明如何满足关注点,这个架构就失去存在价值,"更多是一种债务而不是资产",并提出相应原则,直接支持卡片结论。 - 原始内容:"如果一个架构无法被利益相关者理解,或者无法向他们说明能够满足关注点,那么这个架构也就没有存在的价值了——事实上,它更多是一种债务而不是资产……原则 尽管每个系统都有架构,但并非每个系统都拥有能够通过架构描述进行有效沟通的架构。"