最佳實務 - AWS規範指導

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

最佳實務

促進擁有權。每個項目團隊成員都應有權創建和擁有一個 ADR。此實踐會在團隊成員之間分配架構研究工作,並從解決方案架構師或團隊領導處卸下工作。它還在決策過程中培養一種主人翁感。這有助於團隊更快地通過這些決策,而不是將它們視為來自組織較高級別的決定。

保留 ADR 歷史記錄。ADR 應具有更改歷史記錄,並且每個更改都應具有所有者。當 ADR 所有者更新 ADR 時,他們應將舊 ADR 的狀態更改為已取代,請記下新 ADR 的更改歷史記錄中的更改,並將舊的 ADR 保留在決策日誌中。

安排定期審查會議。如果您正在進行一個新的(新建)項目,ADR 過程在開始時可能會非常激烈。我們建議您在每日站立之前或之後建立定期的 ADR 討論和審查會議的節奏。通過這種方法,定義的 ADR 將在兩個或三次衝刺中穩定下來,並且您可以通過減少會議打下堅實的基礎。

將 ADR 存儲在一箇中心位置。每個項目成員都應有權訪問 ADR 集合。我們建議您將 ADR 存儲在一箇中心位置,並在項目文檔的主頁上引用它們。存儲 ADR 有兩種常用的選項:

  • Git 儲存儲存儲存儲存儲存儲存儲存儲存儲存儲存儲存儲存

  • Wiki 頁面,使所有團隊成員都可以訪問 ADR

解決不相容的代碼。ADR 過程不能解決不符合舊代碼的問題。如果您的舊代碼不支持已建立的 ADR,則可以逐步更新過時的代碼庫或工件,同時引入新的更改,或者您的團隊可以決定通過創建技術負債任務來明確重構代碼。