ADR 團隊協作建議

如果你正在考慮讓團隊使用決策記錄,下面是我們在與許多團隊合作中積累的一些建議。

你有機會引領你的隊友,方法是共同討論「為什麼」,而不是強制規定「做什麼」。例如,決策記錄是團隊更聰明地思考、更好地溝通的一種方式;如果它只是事後被迫完成的文書工作,決策記錄就沒有價值。

有些團隊更喜歡「決策」(decisions)這個名稱,而不是縮寫“ADR”。當一些團隊使用“decisions”作為目錄名時,就像燈泡突然亮了,團隊開始往該目錄中放入更多資訊,例如供應商決策、規劃決策、排期決策等。所有這些型別的資訊都可以使用同一個範本。我們推測,相比縮寫(“ADR”),人們用完整的詞(「決策」)學得更快;去掉「記錄」(record)這個詞之後,人們更有動力撰寫進行中的文件;此外,一些開發人員和一些管理者不喜歡「架構」這個詞。

理論上,不可變性是理想的。實踐中,可變性對我們的團隊效果更好。我們會把新資訊插入現有的 ADR,並附上日期戳,以及一條說明該資訊是在決策之後才獲得的備註。這種做法會形成一份我們所有人都能更新的「活文件」。典型的更新場景包括:因新隊友加入、新產品出現或實際使用的真實結果而獲得了資訊,或者出現了事後的第三方變化,例如供應商的能力、定價方案、許可通訊協定等。