文件的作用和分類

**自標準化資訊網　　　2023年04月21日

軟體文件(document)也稱檔案，通常指的是一些記錄的資料和資料**，它具有固定不變的形式，可被人和計算機閱讀。它和電腦程式共同構成了能完成特定功能的計算機軟體(有人把源程式也當作文件的一部分)。我們知道，硬體產品和產品資料在整個生產過程中都是有形可見的，軟體生產則有很大不同，文件本身就是軟體產品。沒有文件的軟體，不成其為軟體，更談不到軟體產品。軟體文件的編制(documentation)在軟體開發工作中占有突出的地位和相當的工作量。高效率、高質量地開發、分發、管理和維護文件對於轉讓、變更、修正、擴充和使用文件，對於充分發揮軟件產品的效益有著重要意義。然而，在實際工作中，文件在編制和使用中存在著許多問題，有待於解決。軟體開發人員中較普遍地存在著對編制文件不感興趣的現象。從使用者方面看，他們又常常抱怨：文件售價太高、文檔不夠完整、文件編寫得不好、文件已經陳舊或是文件太多，難於使用等等。究竟應該怎樣要求它，文件應該寫哪些，說明什麼問題，起什麼作用?這裡將給出簡要的介紹。

圖文件橋梁作用

文件在軟體開發人員、軟體管理人員、維護人員、使用者以及計算機之間的多種橋梁作用可從圖中看出。軟體開發人員在各個階段中以文件作為前階段工作成果的體現和後階段工作的依據，這個作用是顯而易見的。軟體開發過程中軟體開發人員需制定一些工作計畫或工作報告，這些計畫和報告都要提供給管理人員，並得到必要的支援。管理人員則可通過這些文件了解軟體開發專案安排、進度、資源使用和成果等。軟體開發人員需為使用者了解軟體的使用、操作和維護提供詳細的資料，我們稱此為使用者文件。

以上三種文件構成了軟體文件的主要部分。我們把這三種文件所包括的內容列在圖6中。其中列舉了十三個文件，這裡對它們作一些簡要說明：

· 可行性研究報告：說明該軟體開發專案的實現在技術上、經濟上和社會因素上的可行性，評述為了合理地達到開發目標可供選擇的各種可能實施的方案，說明並論證所選定實施方案的理由。

· 專案開發計畫：為軟體專案實施方案制定出具體計畫，應該包括各部分工作的負責人員、開發的進度、開發經費的預算、所需的硬體及軟體資源等。專案開發計畫應提供給管理部門，並作為開發階段評審的參考。

· 軟體需求說明書：也稱軟體規格說明書，其中對所開發軟體的功能、效能、使用者介面及執行環境等作出詳細的說明。它是用戶與開發人員雙方對軟體需求取得共同理解基礎上達成的協議，也是實施開發工作的基礎。

· 資料要求說明書：該說明書應給出資料邏輯描述和資料採集的各項要求，為生成和維護系統資料文捲作好準備。

· 概要設計說明書：該說明書是概要設計階段的工作成果，它應說明功能分配、模塊劃分、程式的總體結構、輸入輸出以及介面設計、執行設計、資料結構設計和出錯處理設計等，為詳細設計奠定基礎。

· 詳細設計說明書：著重描述每一模組是怎樣實現的，包括實現演算法、邏輯流程等。

·使用者手冊：本手冊詳細描述軟體的功能、效能和使用者介面，使使用者了解如何使用該軟體。

圖三種文件

· 操作手冊：本手冊為操作人員提供該軟體各種運**況的有關知識，特別是操作方法的具體細節。

· 測試計畫：為做好組裝測試和確認測試，需為如何組織測試制定實施計畫。計畫應包括測試的內容、進度、條件、人員、測試用例的選取原則、測試結果允許的偏差範圍等。

· 測試分析報告：測試工作完成以後，應提交測試計畫執行情況的說明。對測試結果加以分析，並提出測試的結論意見。

· 開發進度月報：該月報系軟體人員按月向管理部門提交的專案進展情況報告。報告應包括進度計畫與實際執**況的比較、階段成果、遇到的問題和解決的辦法以及下個月的打算等。

· 專案開發總結報告：軟體專案開發完成以後，應與專案實施計畫對照，總結實際執行的情況，如進度、成果、資源利用、成本和投入的人力。此外還需對開發工作作出評價，總結出經驗和教訓。

· 哪些需求要被滿足，即回答"做什麼?"

· 所開發的軟體在什麼環境中實現以及所需資訊從**來，即回答"從何處?"

· 某些開發工作的時間如何安排，即回答"何時幹?"

· 某些開發(或維護)工作打算由"誰來幹?" · 某些需求是怎麼實現的?

· 為什麼要進行那些軟體開發或維護修改工作? 上述十三個文件都在一定程度上回答了這六個方面的問題。這可從表中看到。

表文件所回答的問題

至此，我們對文件的作用有了進一步的理解。每乙個文件的任務也是明確的，任何乙個文件都此是多餘的。

文件的作用和分類

文件的作用和分類

文件的作用和分類

軟體文件的作用和分類

相關推薦