“Our architecture diagram is out of date” is a universal team pain. Here’s how to use CI to bind diagrams to the codebase — auto-check, auto-rerender, staleness alerts, PR thumbnails.
The anti-pa...
「我们画的架构图过期了」是每个团队的痛。这篇讲怎么用 CI 让图永远跟得上代码 —— 自动检查、自动重渲染、过期提醒、PR 自动出图。
反模式：写一张图就忘123docs/architecture/ flow.png # 2023 年画的，没人维护README.md
半年后服务下线了、新服务上线了，这张 flow.png 还是 2023 年的样子。架构图活在真空里。
正...
This isn’t about how to use PlantUML. It’s about seven ways that “work, but suck” — pulled from real PR reviews and rewrites of my own old diagrams.
1. One diagram, 200 linesThe most common one. ...
这篇不是讲 PlantUML 怎么用，是讲 PlantUML 的 7 种「能跑，但是烂」写法。每条都是被同事代码评审 / 自己回看旧图踩过坑后总结的。
1. 一张图塞 200 行最常见的反模式之一。一张时序图想表达 12 个服务、40+ 步骤，评审者根本看不下去。
12345678910111213141516171819202122232425262728293031@sta...
Diagrams usually get skipped during PR review because most teams keep them in Confluence or PowerPoint. Here’s how to push them through review the same way you push code.
Why we don’t put diagram...
PR 评审里图往往被遗漏，因为大多数团队把图放在 Confluence 或者 PPT 里。这篇讲怎么把 PlantUML 当代码一样放进 PR。
为什么不把图放进 PR最常见的几个借口：
「图是设计阶段画的，开发评审不动」
「图很大、牵一发动全身，合并时容易漏」
「评审系统看不到图，没有评审意义」
这些借口在 PlantUML + GitHub/GitLab 渲染器面前都不...
Two paths to embed PlantUML in a static blog: pre-render on the server, or have the reader’s browser render on the fly. Here’s the field guide.
Option A: Server-side render (hexo-renderer-plantum...
把 PlantUML 嵌进静态博客有两条路：本地/服务端事先渲染，或者让读者浏览器现渲染。这篇是两套方案的踩坑总结。
方案 A：服务端渲染（hexo-renderer-plantuml）工作流：<hexo> hexo generate 阶段把 ```plantuml 代码块渲染成 SVG 图片，生成的 HTML 直接包含 <svg>，不需要客户端 JS。...
There’s no “best” diagram tool, only the right one for each situation. This is the distillation of several tool switches.
One-line conclusion
Type
Pick
Why
Sequence, class, state, activity, ...
不存在「最好」的图工具，只有最合适的那一个。这篇是经过几次切换后的总结。
一句话结论
类型
推荐
理由
时序图、类图、状态图、活动图、组件图、部署图、用例图
PlantUML
语法最完整，几乎所有 UML 图都有
流程图（if/else/while）、ER 图、甘特图、Git graph、架构速写
Mermaid
集成度高，GitHub/Git...
