#decision
Michael Nygard写了一篇关于以模式形式记录重要架构决策的博文:
我们将使用只有几个部分的格式,因此每个文档都易于消化。格式只有几个部分。
标题 这些文件的名称是短名词短语。例如,“ADR 1:在Ruby on Rails 3.0.10上部署”或“ADR 9:用于多租户集成的LDAP”
上下文 本节描述起作用的力量,包括技术、政治、社会和本地项目。这些力量可能处于紧张状态,应该这样称呼。本节中的语言是价值中立的。它只是描述事实。
决定 本节描述了我们对这些力量的反应。它以完整的句子陈述,并有活跃的声音。“我们会……”
状态 如果项目利益相关者尚未同意,则可以“提出”决定,一旦同意,则可以“接受”。如果后来的ADR更改或推翻了决定,它可能会被标记为“已弃用”或“被取代”,并提及其替换。
后果 本节描述应用决定后的结果上下文。所有后果都应该列在这里,而不仅仅是“积极”的后果。特定决定可能会产生积极、消极和中立的后果,但所有这些后果都会影响未来的团队和项目。
引自Michael Nygard
您可以将此ADR格式描述为表格。
我(Gernot)错过了决策标准(见提示9-2(文件决策标准))-但也许我在这方面过于特殊……