程序與文檔合一概念的提出
一、目前軟件的狀況
程序與文檔的形式分離，不僅是用各自獨立的形式存放，而且使用不同的工具在不同的時間里書寫和檢索。維護程序時不能方便地得到文檔的幫助，不能同步修改文檔。
程序與文檔的內容分離，由于程序與文檔采用不同的描述，既有計算機語言也有自然語言。維護過程中不能及時、一致地更新文檔或程序，使文檔不能準確地描述程序而幾乎成為廢紙甚至帶來負面價值。
軟件開發與維護的分離，絕大多數軟件在設計、開發時不太考慮以后可能的修改，加大了軟件維護的難度，而且使維護容易引入新的錯誤。
這些分離也表現在設計、開發的不同階段的文檔之間的不相容性，例如：需求分析說明書是紙上的東西，在概要設計階段不能很好地繼承、利用需求分析說明書，設計、編制概要設計時必須從零開始，需要重新分析、理解需求分析，這種思維上的脫節，不僅延緩開發進度、加重設計人員的負擔，而且由于理解上的不同導致不同階段描述的對象有許多不相容情況。這些分離使得文檔在系統的設計、開發、維護中的作用下降，這也是很多軟件人員不愿意編寫文檔的主要原因。
二、程序與文檔合一的概念提出
怎樣才是好的文檔系統呢？應當具備以下屬性：
1. 能夠準確地描述軟件、并且簡單易懂；
2. 能夠迅速錯誤定位、影響分析、修正設計；
3. 能夠提高軟件維護質量；
4. 能夠方便程序修改時理解程序。
為此提出了程序與文檔合一的概念。這概念使軟件成為真正意義上的軟件：程序+文檔，程序就是文檔，文檔集成在程序中。它要求在選擇開發環境時不僅要考慮環境對設計、開發的完美支持，而且要考慮對維護、文檔的支持；它要求軟件人員在設計、開發過程中要考慮維護問題、文檔問題；它要求程序與文檔存儲在同一位置、同一系統中；它要求使用相同工具進行程序與文檔的書寫、檢索；它要求在編寫和維護程序的同時形成文檔，在書寫文檔時編寫、維護程序。程序與文檔合一的概念不僅存在于系統的設計、開發階段而且存在于系統的維護階段，它貫穿軟件的生命周期。
動態文檔系統是建立在程序與文檔合一的概念基礎上的、文檔與程序一致的、簡單易懂的聯機文檔系統。它包括構件說明與數據描述、對構件與構件之間、構件與數據之間的關系進行的描述。動態文檔系統是提高了文檔的可用性、易用性和連貫性，使文檔更加有效，是解決維護問題的有效途徑。
動態文檔系統問題分析
需要解決的問題是：軟件文檔的內容劃分與獲取、文檔的存儲與維護、文檔的檢索、軟件文檔的生成打印。
一、軟件文檔的內容劃分成：語義文檔、結構文檔、過程文檔
語義文檔是對軟件的功能、概念、總體設計、流程、規約等用自然語言的描述，是軟件人員根據規范在使用CASE工具編寫并填入程序的文檔，它也是為更全面的解釋文檔而靈活加入的額外信息。
結構文檔是在軟件設計工具、開發環境中對象的屬性、構件間接口、構件間引用關系、軟件的結構等的描述。利用詞法、語法分析程序對整個系統的對象、構件進行識別、分析，獲取上述描述并形成表格文件。
過程文檔是對軟件的設計、編碼、維護過程中形成的過程描述和程序注釋，如設計目的、設計人、時間等說明，利用開發環境對軟件人員在設計、開發、維護過程中操作的記錄形成操作跟蹤。
延伸閱讀
文章來源于領測軟件測試網 http://www.kjueaiud.com/
