一般說來,文檔編制策略陳述要明確,并通告到每個人且理解它,進而使策略被他們貫徹實施。
支持有效文檔策略的基本條件:
a) 文檔需要覆蓋整個軟件生存期
在項目早期幾個階段就要求有文檔,而且在貫穿軟件開發過程中必須是可用的和可維護的。在開發完成后,文檔應滿足軟件的使用、維護、增強、轉換或傳輸。
b) 文檔應是可管理的
指導和控制文檔的獲得維護,管理者和發行專家應準備文檔產品、進度、可靠性、資源,質量保證和評審規程的詳細計劃大綱。
c) 文檔應適合于它的讀者
讀者可能是管理者、分析員、無計算機經驗的專業人員、維護人員、文書人員等。根據任務的執行,他們要求不同的材料表示和不同的詳細程度。針對不同的讀者,發行專家應負責設計不同類型的文檔。
d) 文檔效應應貫穿到軟件的整個開發過程中
在軟件開發的整個過程中,應充分體現文檔的作用和限制,即文檔應指導全部開發過程。
e) 文檔標準應被標識和使用
應盡可能地采納現行的標準,若沒有合適的現行標準,必要時應研制適用的標準或指南。
f) 應規定支持工具
工具有助于開發和維護軟件產品,包括文檔。因此盡可能地使用工具是經濟的、可行的。
延伸閱讀
文章來源于領測軟件測試網 http://www.k11sc111.com/