沟通模式

第 5 章 注释 符号

本作品已使用人工智能进行翻译。欢迎您提供反馈和意见：[e-mail]

创建图表时，您可以使用标准符号，如统一建模语言 (UML) 或业务流程模型和符号(BPMN)，也可以使用非标准符号（如您自己的符号，或公司的方框和线条标准）。¹

你可能不会过多地考虑你所使用的符号，或者相反，你花了太多的时间来决定使用哪种符号。本章将介绍几种反模式，引导你了解标准或非标准符号会在哪些方面降低与受众成功交流的可能性。

使用图标传递意义

使用图标来表达含义是一种 反模式，它产生于云提供商图标几乎成为一种正式的符号。在 Cloud 出现之前，人们很少使用技术图标（如 SQL Server、Java 或 Python）来创建图表，而且绝对不会在不使用标签的情况下创建图表。但现在，云提供商的文档中充满了图表，显示了代表其数据存储、无服务器功能和平台即服务（PaaS）产品等版本的图标。

警告

云提供商图标集因各种原因（包括新服务）经常更新。不同的版本可直接用于图表应用程序，如draw.io。请使用清晰的标签，并明确指出服务的版本或类型，以免在未来图标发生变化时产生混淆。

在图表中使用技术图标本身并不是坏事，但将其作为唯一的交流形式（或与很少的文字信息一起使用）会让受众感到困惑。遵循这种反模式的图表可以看作是对受众对云提供商图标的了解程度的测试。如果受众不知道图标代表什么，就无法理解图表试图传达的信息。

在考虑图表中的图标时，问问自己为什么要使用这些图标。答案不应该是为了传递信息，因为你无法相信受众中的每个人都能完全理解你所使用的图标。这就好比添加了另一种语言的标签，却期望受众中的每个人都懂得这种额外的语言，或者使用缩略语却不对其进行定义。²

只在想要传达的信息之外使用图标。使用标签，并确保所使用的文字也清晰明了。您应该可以移除图标，但信息仍然可以理解。如果您的图表包含图标，但没有标签，而您又无法（或没有时间）对其进行编辑，那么可以添加一个图例，说明每个图标的定义。考虑一下你的图标是否会使你的图表变得杂乱无章，让人更难理解，而不是增加信息量。

提示

要测试图标或徽标是否用于传达信息，可尝试将其从图表中完全移除，并检查标签和其他方法是否仍能有效传达信息。

如果使用图标来表示信息，那么在图标中加入描述性文字也是不错的做法。例如，要显示分数或评级，，你可以在三颗半星旁边加上3.5/5，使信息更明确，可访问 。³

图 5-1显示了为图标和关系添加标签（位于图的顶部）与不添加标签（位于图的底部）之间的区别。你可以理解为什么互联网流量会被路由到 Azure CDN，但为什么会被路由到下面的组件，这个组件是什么？它就是Azure Front Door，但你不能假定你的受众知道这一点，也不能假定他们会知道所有对非静态内容的请求都会以这种方式路由。

提示

云提供商文档通常介于图 5-1所示示例（上图和下图）之间：比完全没有标签要好，但仍假设受众知道图标的含义。因此，请避免使用直接从云文档中摘录的图表。

图 5-1. 带标签（上）和不带标签（下）的云提供商图

为了 UML 而使用 UML

UML 如果使用得当，UML 是一种非常有用的符号，但很多人都会认为，无论图表的受众或原因是什么，都应该使用 UML。决定是否使用 ...