One Size Fits All? An Empirical Comparison of ADR Templates regarding Comprehension, Usability, and Ease of Adoption
本文通过专家筛选和受控实验，对五种架构决策记录（ADR）模板进行了实证评估，结果表明尼加德（Nygard）的模板在整体理解性和可用性方面表现更优，从而为从业者选择最有效的文档格式提供了基于证据的指导。
原始论文采用 CC BY 4.0 许可（http://creativecommons.org/licenses/by/4.0/）。 这是对下方论文的AI生成解释。它不是由作者撰写或认可的。如需技术准确性，请参阅原始论文。 阅读完整免责声明
想象一下，你正在建造一座庞大而复杂的乐高城堡。你和你的团队在过程中会做出数百个微小的决定：“这座塔应该是红色还是蓝色？”“我们用圆形积木还是方形积木？”“我们为什么决定把吊桥放在这里？”
如果你不把这些决定记录下来，两年后，当一位新加入的建造者加入团队时，他们将完全不知道城堡为何是现在的样子。他们可能会把一座红色的塔改成蓝色，却没意识到红色是为了匹配故事中的日落。这种“为什么”的缺失，正是该论文所称的知识蒸发——那些被遗忘的想法化作无形的蒸汽，让你的项目变得困惑且混乱。
为了防止这种情况，软件团队会使用一种称为**ADR（架构决策记录）**的东西。把 ADR 想象成针对特定建筑选择的微型日记条目。但问题在于：存在许多不同的“日记模板”。有些就像只有三行文字的简单明信片；而另一些则像长达 20 页的法律合同，为每一个可能的细节都设置了复选框。
这篇论文提出的核心问题是：“是否存在一种能适用于所有情况的完美模板，还是我们需要针对不同任务使用不同的模板？”
实验：模板的“品尝测试”
研究人员并非凭空猜测，而是进行了一场科学的“品尝测试”。
第一步：专家评委
首先，两位专家架构师（即论文作者）审视了五种流行的模板。他们像美食评论家一样，根据以下三点对模板进行评分：
- 可理解性：是否易于阅读和理解？
- 可用性：填写是否快速简便？
- 采用意愿：你是否真的想在日常工作中使用它？
他们将范围缩小到了两个“最美味”的选项：
- Nygard 模板：即“明信片”。它简短、简单，直奔主题。
- MADR：即“详细报告”。它结构严谨，包含更多部分，并迫使你思考优缺点及替代方案。
第二步：学生厨师
接下来，他们引入了 33 名软件工程学生（扮演初级建造者）。学生们被分成两组，并面临两个不同的“建筑挑战”（例如决定如何连接外部服务，或选择哪种数据库）。
- A 组在第一个挑战中使用 Nygard 模板，在第二个挑战中使用 MADR 模板。
- B 组则完全相反。
这种“交叉”设计确保了每个人都尝试了两种风格，因此结果不仅仅关乎谁更擅长写作，而是关乎哪种模板实际上更易于使用。
结果：视情况而定
研究发现，不存在“放之四海而皆准”的模板。最佳模板完全取决于你的具体情境。
1. “速度跑”获胜者：Nygard
当学生需要快速撰写，或者项目规模较小且敏捷时，他们偏爱Nygard。
- 类比：这就像点一杯快捷的咖啡。你走进去，说“拿铁”，付钱，然后离开。
- 获胜原因：填写速度更快，令人困惑更少，感觉也不像“家庭作业”。学生们觉得它“直奔主题”。如果你时间紧迫或正在处理小型项目，这就是你的首选。
2. “深度挖掘”获胜者：MADR
当学生拥有更多时间，或者决策感觉非常重要且复杂时，他们更倾向于MADR。
- 类比：这就像一份带有详细菜单的正餐。你需要填写更多字段，但它迫使你思考为什么选择汤而不是沙拉。
- 获胜原因：它减少了歧义。因为它包含更多部分（如“优点”、“缺点”和“替代方案”），所以推理更加清晰，不易产生误解。它更适合那些容不得含糊的大型关键项目。
结论
该论文得出结论：选择模板并非关于挑选整体“最好”的一个，而是关于为工作挑选正确的工具：
- 当你行动迅速、项目规模较小，或者只需快速记录决策而不想陷入繁琐细节时，使用“明信片”（Nygard）。
- 当决策至关重要、项目规模巨大，或者你需要确保每个人都理解选择背后的深层推理时，使用“详细报告”（MADR）。
主要启示很简单：不要将复杂、详细的模板强加给快速、小型的任务，也不要用一张小小的明信片去处理关乎生死的重大决策。 让模板与项目的规模和紧迫性相匹配。
您所在领域的论文太多了？
获取与您研究关键词匹配的最新论文每日摘要——附技术摘要，使用您的语言。