“获得一幅图”方法处理体系结构文档

我花了很多时间来撰写无人阅读的页面和架构文档页面。 我加入了太多的项目，这些项目具有庞大的过时且无用的架构文档。 我见过太多的架构文档，这些文档令人麻木地描述应该是图表的散文。 我烦死了。 如今，我的规则是每个团队都得到一张图表。 那是架构文档。 它可以像需要的那样复杂，但是每个团队只能有一个。 一张图片胜过千言万语。 没有比架构文档更真实的了。 没有人愿意坐在那里阅读数十页的散文，而只能看图表。 维护所有这些文本页面是一场噩梦，因为随着时间的推移，几乎没有什么变化。

信息过期的可能性随图表的数量成倍增加，而不是成比例地增加。 最终，两个“不相关”的事物将需要它们之间我们没有预见到的联系。