ADR 团队协作建议

如果你正在考虑让团队使用决策记录,下面是我们在与许多团队合作中积累的一些建议。

你有机会引领你的队友,方法是共同讨论“为什么”,而不是强制规定“做什么”。例如,决策记录是团队更聪明地思考、更好地沟通的一种方式;如果它只是事后被迫完成的文书工作,决策记录就没有价值。

有些团队更喜欢“决策”(decisions)这个名称,而不是缩写“ADR”。当一些团队使用“decisions”作为目录名时,就像灯泡突然亮了,团队开始往该目录中放入更多信息,例如供应商决策、规划决策、排期决策等。所有这些类型的信息都可以使用同一个模板。我们推测,相比缩写(“ADR”),人们用完整的词(“决策”)学得更快;去掉“记录”(record)这个词之后,人们更有动力撰写进行中的文档;此外,一些开发人员和一些管理者不喜欢“架构”这个词。

理论上,不可变性是理想的。实践中,可变性对我们的团队效果更好。我们会把新信息插入现有的 ADR,并附上日期戳,以及一条说明该信息是在决策之后才获得的备注。这种做法会形成一份我们所有人都能更新的“活文档”。典型的更新场景包括:因新队友加入、新产品出现或实际使用的真实结果而获得了信息,或者出现了事后的第三方变化,例如供应商的能力、定价方案、许可协议等。