文章關鍵要點
1、通過創建和維護架構圖來提供準確且有價值的內容并非易事。大多數情況下,我們要么創建了太多的文檔,要么太少,或者不相關,因為我們沒能準確地定位文檔的受益人及其實際的需求。
2、我們常犯的最大的一個錯誤是為系統中具有高波動性的部分創建詳細的架構圖。除非是自動生成的,否則手動維護它們對我們來說就是一種負擔。
3、在實踐中,大多數利益相關者對詳細架構圖不感興趣,但會對一兩個反映系統模塊和邊界的高級架構圖感興趣。除此之外,要深入理解系統,代碼才是事實的來源,但在大多數情況下,只有開發人員會對代碼感興趣。
4、為了創建具備一定質量的架構圖,可以進行頭腦風暴,并與團隊就什么對他們來說才是真正有用的東西上達成一致。不要嘗試為源代碼中不言自明的東西或為了迎合架構方法而創建架構圖。
5、架構圖的主要目的應該是促進協作、增強溝通、提供愿景和指導。
在墻上繪制一兩個高級架構圖并在會議(站會等)期間使用它們。作為一名架構師,你應該讓它們可見,變得有價值,并作為項目文化的一部分。不要將它們隱藏起來或放在利益相關者不易接觸到的地方。