【系统架构设计百科】架构决策与 ADR：如何做出可追溯的技术决策
口头约定的架构决策会在人员流动中丢失，会在争论中反复翻车。ADR（Architecture Decision Records）用一种轻量的文档格式，把每一个关键技术决策的背景、选项、理由和代价写下来，跟着代码一起版本管理。本文从 ADR 的三种主流格式讲到 Git 仓库中的实操管理，再拆解 Spotify 和 Uber 的工业实践。
adr 标签归档
共 2 篇文章 · 返回首页
【系统架构设计百科】架构视图与文档：C4 模型从入门到实战
架构图画完三个月就过期，架构文档写完没人看。问题不在于画不画，而在于用什么模型画、用什么方式维护。本文从 C4 模型的四层视图出发，拆解 diagram-as-code 工具链和文档即代码的工程实践，给出一套让架构文档能活下来的方法。