系統的構架取決於對構架的需求，因此構架的文件也取決於對文件的需求——也就是說，我們希望如何使用該文件。構架文件不僅是說明性的，而且是描述性的，也就是說，對於某些觀眾來說，它通過對要指定的決策做出限制，來說明哪些內容是真實的。
我們需要對檢視進行編檔、對行為進行編檔、對介面進行編檔、對介面進行編檔的模板。在對介面進行編檔的時候我們需要識別介面身份對介面進行命名（可能還需要提供乙個版本號）、提供一些資源（這個是介面文件的核心）、資料型別定義（如果任何介面資源採用了非底層程式語言提供的資料型別，設計是就需要傳達該資料型別的定義。如果它是由另乙個元素定義的，那麼，對該元素文件中的定義進行引用就足夠了）、異常定義（異常定義描述了可以由介面上的資源引發的異常 ）、該介面提供的可變性、介面的質量屬性特徵、元素需求、基本原理和設計問題、使用指南。系統概述簡要說明了系統的功能，其使用者是誰以及任何重要的背景或限制條件。目的是使讀者在頭腦中對系統及其目的有乙個一致的模型。有時，整個系統有乙個系統概述，在這種情況下，構架文件的這一部分將指向該系統概述。因為構架的所有檢視描述的都是同乙個系統，因此，我們可以合理地推斷出任意兩個檢視都有很多相同的內容。幫助文件的讀者可以理解檢視間的關係能夠使他洞察構架是如何作為乙個統一的概念整體來發揮作用的。可以通過提供檢視間的對映來弄清檢視間的關係，這是加深理解和減少混淆的關鍵所在。元素列表就是出現在任何檢視中的所有元素的索引，連同乙個指向定義每個元素的位置的指標。專案詞彙列出都定義了對系統來說具有特殊含義的術語。
如果誰也不理解構架是什麼或者不知道如何使用它，那麼，這個架構是沒有價值的。在建立構架的過程中，對構架進行編檔是最重要的一步，因為對構架進行編檔後，設計師就不用再回答許多關於構架的問題，而且，現在和以後的涉眾可以通過構架文件來捕獲構架。
軟體構架實踐 閱讀筆記03
寒假生活 讀 軟體構架實踐 7 9章後感 在了解了構架的商業方面 構架檢視和結構 質量屬性等知識，這部分內容旨在構架的設計以及當構架逐漸形成時應該做什麼。軟體架構的設計是指通過一系列的設計活動，獲得滿足系統功能性需求 簡稱fr 並且符合一定非功能性需求 簡稱nfr，與質量屬性有相似涵義 約束的軟體架...
軟體構架實踐閱讀筆記5
把構架作為軟體開發過程基礎的任何組織都需要理解構架在其生命期中的位置。在生命期模型中，構架設計就是從初步的需求分析開始逐步進行迭代，所以在了解系統需求之前，不能開始設計構架，但是剛開始設計構架時並不需要收集太多需求。構架的驅動因素 包括功能 質量和商業需求，為了確定構架驅動因素，需要識別優先順序最高...
軟體構架實踐閱讀筆記2
a 7e架構包括三個結構 模組分解結構 使用結構 程序結構。模組分解結構 對於a 7e這樣的系統發生改動可能是由3個原因造成的 軟體必須與之互動的硬體發生了變化 所要求的系統外部可見行為發生了變化 完全由該項目的軟體設計人員做出的某個決定發生了變化。所以a 7e又可以分為硬體隱藏模組 行為隱藏模組 ...