3.10 記錄架構(gòu)決策：輕量級(jí)架構(gòu)決策記錄

架構(gòu)是一種在持續(xù)變化，并且不斷演進(jìn)的事物。在一個(gè)長期的項(xiàng)目里，我們會(huì)不斷地打開Wiki、文件中心來更新文檔。而遺憾的是，我們可能會(huì)忽略做出這個(gè)架構(gòu)設(shè)計(jì)的原因。因此，我們需要在項(xiàng)目中實(shí)施輕量級(jí)架構(gòu)決策記錄。它同代碼一起，記錄軟件架構(gòu)在其生命周期里發(fā)生的變化、演進(jìn)，等等。

輕量級(jí)架構(gòu)決策記錄是一種輕量級(jí)的架構(gòu)記錄方式，通常使用像Markdown這樣的輕量級(jí)文本格式語言，它們既方便于開發(fā)人員編寫，又適合于版本軟件管理。同時(shí)，它還能結(jié)合到項(xiàng)目的代碼中。架構(gòu)決策記錄將按順序和數(shù)字編號(hào)，并且不會(huì)被重復(fù)使用。這些記錄包含了影響架構(gòu)、非功能需求、依賴關(guān)系、接口或構(gòu)建系統(tǒng)技術(shù)等內(nèi)容。

下面是一個(gè)由adr命令生成的adr/0001-examples.md架構(gòu)決策記錄的示例文件：

        # 1. examples
        日期： 2018-07-30
        ## 狀態(tài)
        2018-07-30 提議
        ## 背景
        在這里補(bǔ)充上下文．..
        ## 決策
        在這里補(bǔ)充上決策信息．..
        ## 后果

在這個(gè)記錄中，它由以下六部分組成：

◎ 標(biāo)題。

◎ 日期。

◎ 描述決策相關(guān)的狀態(tài)，包含提議、通過、完成、已棄用、已取代等。

◎ 價(jià)值中立的、用于描述事實(shí)上下文的背景。

◎ 應(yīng)對(duì)這種場(chǎng)景的相應(yīng)的決策。

◎ 記錄應(yīng)用決策后產(chǎn)生的結(jié)果。

通過它們，我們可以清楚地了解與技術(shù)決策相關(guān)的知識(shí)，給未來的開發(fā)人員做好知識(shí)鋪墊，以便對(duì)系統(tǒng)進(jìn)行進(jìn)一步的演進(jìn)。