软件架构师速成指南

第 III 部分. 交流

建筑师 并非与世隔绝。因此，沟通技巧对建筑师来说至关重要。不过，向不同的受众传达技术内容是一项挑战，因为许多经典的演示或写作技巧并不适合高度技术性的主题。例如，在引人注目的照片上叠加单词的幻灯片可能会吸引观众的注意力，但却无法传达云计算平台战略的复杂性。相反，建筑师需要关注一种强调内容，但又引人入胜、平易近人的沟通方式。

你无法管理你无法理解的事物

"你无法管理你无法测量的东西 "是一句常见的管理口号。然而，要使测量有意义，就必须了解所管理的系统的动态。否则，你就无法知道应该拉动哪些杠杆来影响系统行为（第 10 章）。

在这个技术已经渗透到个人和职业生活方方面面的世界里，了解你正在管理的东西对决策者来说是一个巨大的挑战。即使不指望企业高管亲自编码解决方案，但如果忽视技术的发展和能力，当 IT 系统无法满足业务需求时，就会错失商机或错过期望。在要求以更快的速度高质量交付功能的数字化世界中，仅凭时间安排、人员配备和预算因素来管理复杂的技术项目已经远远不够了（第 40 章）。

架构师必须帮助缩小技术知识持有者与高层决策者之间的差距，清楚地传达技术决策对业务的影响，例如，通过开发和运营成本、灵活性或上市时间。在理解复杂技术方面面临挑战的不仅仅是 "业务类型 "人员。即使是建筑师和开发人员也不可能跟上错综复杂的技术解决方案的所有方面，这就迫使他们也要依靠通俗易懂但技术上准确的架构决策及其影响的描述。

引起注意

技术资料可能非常令人兴奋，但具有讽刺意味的是，对演讲者来说，这比对听众来说更令人兴奋。即使是最热心的听众，在冗长的代码度量或数据中心基础设施介绍中保持注意力也是一件很费力的事。决策者不仅希望看到确凿的事实，还希望参与其中并有动力支持你的建议。因此，架构师必须同时使用大脑的两半，不仅要使材料在逻辑上连贯一致，还要精心设计一个引人入胜的故事。

推（少）纸

我的团队过去发表的 技术决策文件获得了很多赞誉，但也有意想不到的批评，比如 "你们建筑师只会做纸上谈兵"。你可能想先发制人，提醒人们文件在许多方面都能提供价值：

连贯性

就设计原则和决策达成一致并形成文件，可提高决策的一致性，从而保持系统设计概念的完整性。

验证

结构化文档有助于找出设计中的漏洞和不一致之处。

思路清晰

你只能写出你所理解的东西。

教育

如果新团队成员能获得良好的文档资料，他们就能更快地提高工作效率。

历史

决策（第 8 章）基于特定的背景，而这种背景可能已经发生了变化。文件可以帮助您了解这一背景。

利益攸关方沟通

建筑文档可以帮助引导不同的受众达到相同的理解水平。

然而，在开发团队中似乎存在着对编写文档的无端抵制。

备注

如果有人说把自己的想法写下来太费劲，我通常会质疑他们，这很可能是因为他们一开始就没有真正理解事情。

有用的文档并不意味着一沓沓的纸张，恰恰相反：简短的文档更容易被阅读。这就是为什么我的团队编写的大多数技术文档都以五页为限。

代码不就是文档吗？

有些开发人员从不讳言争论，他们声称源代码就是他们的文档。因此，写下任何东西都只是重复，对吗？只要所有受众群体都能访问代码，代码结构合理，并且有搜索等工具，他们说的也许有道理。不过，你的源代码还是不太可能向你的执行赞助人解释你的价值主张和关键决策。为此，你需要乘坐架构师电梯（第 1 章），配备一份清晰明了的文档，直达顶楼。

根据代码生成图表和文档可能很有用，但由此产生的视觉效果往往难以帮助人们 "只见树木，不见森林"。此外，它们也不能很好地解释为什么事情是这样做的，因为它们通常没有适当地强调重点。幸运的是，定义什么是 ...