询问 HN:制作清晰架构图的指南

约定是存在的,但它们大多是垃圾(例如 UML)。

遵循 KISS 原则,带有连接线的盒装元素是最好的(最简单、最容易理解、最不模糊)。 用数学术语来说,它们是“无向图”,“有向图”是相同的,但节点之间的链接具有方向性(“箭头”)。 至少自 1991 年以来在软件中定义这些的标准工具包是 https://graphviz.org/

如果需要展示分布式或复杂系统中元素之间随时间变化的交互情况,标准就是消息序列图 https://en.wikipedia.org/wiki/Message_sequence_chart。 最好的(即最长期稳定的)工具是 这是受 graphviz 启发的。

近来有很多衍生版本,例如网络原生版本、风格化版本等,但如果你想要清晰、可移植和可维护,那么这些在功能上都是无关紧要的。 他们的名单经常发布到 HN。 基本工作流程是“想要交流一些东西”,“在文本中定义”(可以通过代码完成),“生成图像”,可选择返回并完善。

这些工具还有一些高级功能,可以创建复杂的图表,如表格协议结构图或数据库结构图、可点击版本、颜色突出显示和 SVG 交互式图表。

1714604279
#询问 #HN制作清晰架构图的指南
2024-05-01 18:02:59

Leave a Reply

Your email address will not be published. Required fields are marked *

近期新闻​

编辑精选​