AllyHub
Content Creation

框图生成器

一种保持同一层级的框图——不会出现服务与功能并列,这通常是这些图变得不可读的地方。

在下方输入内容

框图生成器能做什么

框图是由需要理解方框之间共同点的人来阅读的。下面:它从什么中提取、它保持了什么一致,以及它如何处理已经超出页面范围的系统。

无论你如何解释

用你自己的话描述,或直接提供规格说明——各部分、连接关系以及它们之间流动的内容,都会以绘制图表的形式呈现。

通篇保持同一层级

这次说明方框代表什么——服务、容器、模块、信号——整个页面都会保持在这一层级。任何处于更低或更高层级的内容都会被提升,而不是被悄悄画进去。

为易懂而布局

方框的摆放使得线条可以被跟随而不是交叉成结,当连接数量超出单张图时,你会得到提示,而不是收到一团乱麻。

如何使用 AllyHub 创建框图

从你能口头解释的系统,到别人能读懂的图表,只需三步。

01

描述它

说明各部分是什么以及它们如何连接。一份规格说明、README,或在输入框中输入三段文字都可以。

02

设定层级

这次说明方框代表什么。这一个决定对图表可读性的影响超过任何布局选择。

03

检查,然后保存

对照你的本意重新阅读它,尤其是它提出的任何内容。将这次运行保存为 Playbook,这样系统的下一个版本就会以同样的方式绘制出来。

为什么选择 AllyHub 的框图生成器

形状库和模板解决了绘图问题。但绘图并不是上次图表无人阅读的原因。

混合层级会毁掉它

把一个名为“身份验证服务”的方框放在一个名为“结账时的重试循环”的方框旁边,读者就会无所适从。这通常是图表不再被阅读的地方,而任何画布都不会提到这一点。

Extract More Than Text

它不是为你画的

你已经知道系统是如何工作的;这正是你能描述它的原因。图表的存在是为了那些不知道的人,因此他们的阅读才是唯一重要的检验——而这个检验恰恰是你最难以自行完成的。

Bulk Extraction, Any Scale

你的描述,而非你的系统

坦白说:这个工具基于你的描述工作,而非你的系统——它没有看过你的代码库。如果你描述的模型在某处已经过时,图表也会在相同的地方自信地出错。忠实地绘制并不等于正确地绘制。

From Extraction to Action

第二版成本更低

第一版是成本最高的——正是在这里确定了层级、术语和布局规范。之后它会被保存,你的 AllyHub 再也不必从头开始,因此每次变更后的重新绘制都会越来越快。

Workflows That Compound

谁在使用 AllyHub 的框图生成器

工程师解释架构、售前团队编写提案、团队撰写入职文档,以及任何需要展示设备或系统如何组合的人。

工程与技术负责人

需要解释架构的情况比任何人预想的都要频繁——评审、新员工入职、事故复盘。每次都在白板上重新画图,然后又被擦掉。

产品与售前

提案中总会有一部分展示各部分如何组合,而阅读它的人往往不会看下面的文字。它的重要性通常远超其制作时间所暗示的。

文档与入职

新成员在团队的第一周,往往是在拼凑一张其他人脑中已有的图景。把它写下来一次,就能把反复出现的对话变成一页文档。

工程与教学

设备如何组合、什么给什么供料、信号去向何处——布置物理或流程系统是同样的绘图问题,同样适用可读性规则。

关于框图生成器的常见问题

它绘制什么、保持什么一致、以及它没有看到什么。

什么是框图?

它是一种系统的图形化表示,其中方框代表组成部分,线条代表它们之间的连接或传递的内容。它有意停留在细节之上——重点是整体的形状,而不是某个部分内部如何运作。

AllyHub 的框图生成器免费吗?

是的。单个图表可以在免费套餐中使用。更大的系统、在整个文档集中保持一套规范,以及保存运行以便重新绘制时保持一致,这些属于付费套餐。

如果有内容不符合层级怎么办?

你会得到提示,而不是被直接画进去。然后由你决定:忽略它、提升其余部分以匹配,或者将它留到下一层级的第二张图中。如果连接数量超出单张图的范围,你也会听到这种提示。

它会读取我的代码或基础设施吗?

不会。它只依据你的描述或你提供的文档工作,无法访问代码仓库、云账户或运行中的系统。这是一个值得了解的实质性限制,因为基于过时心智模型绘制的图表,看起来会和正确图表一样具有权威性。

AllyHub 与其他框图工具有什么不同?

其他工具是画布:形状、模板和空白页面,假设绘图就是工作本身。而在这里,层级在整个图片中强制执行,布局为你完成,你确定的规范会带入下一个版本。你得到的是一张图像而不是可编辑的面板——当团队需要一起移动方框时,白板仍然是合适的工具。