Architecture Decision Record
← 文件

如何開始使用 ADR

要開始使用 ADR,請與你的隊友討論以下幾個方面。

決策識別:

  • 這項 AD 有多緊急、多重要?

  • 必須現在做出決定,還是可以等到了解更多資訊之後?

  • 個人和集體的經驗,以及公認的設計方法與實踐,都有助於識別決策。

  • 理想情況下,維護一份與產品待辦事項相互補充的決策待辦清單。

決策制定:

  • 存在許多決策制定技術,既有通用的,也有專門針對軟體架構的,例如對話對映(dialogue mapping)。

  • 群體決策是一個活躍的研究課題。

決策實施與執行:

  • AD 用於軟體設計;因此必須將其傳達給出資、開發和運營該系統的利益相關者,並獲得他們的接受。

  • 架構上一目瞭然的編碼風格,以及關注架構問題和決策的程式碼評審,是兩項相關的實踐。

  • 在軟體演進過程中對軟體系統進行現代化改造時,也必須(重新)考慮 AD。

決策共享(可選):

  • 許多 AD 會在不同專案中反覆出現。

  • 因此,在採用明確的知識管理策略時,過往決策的經驗(無論好壞)都可以成為寶貴的可複用資產。

決策文件化:

  • 存在許多用於記錄決策的範本和工具。

  • 參見敏捷社群,例如 M. Nygard 的 ADR。

  • 參見傳統的軟體工程和架構設計流程,例如 IBM UMF 以及 CapitalOne 的 Tyree 和 Akerman 所建議的表格佈局。

更多資訊: