軟體文件(document)也稱檔案,通常指的是一些記錄的資料 和資料**,它具有固定不變的形式,可被人和計算機閱讀。它和 電腦程式共同構成了能完成特定功能的計算機軟體(有人把源 程式也當作文件的一部分)。我們知道,硬體產品和產品資料在整 個生產過程中都是有形可見的,軟體生產則有很大不同,文件本 身就是軟體產品。沒有文件的軟體,不成其為軟體,更談不到軟體 產品。軟體文件的編制(documentation)在軟體開發工作中占有突 出的地位和相當的工作量。高效率、高質量地開發、分發、管理和維 護文件對於轉讓、變更、修正、擴充和使用文件,對於充分發揮軟 件產品的效益有著重要意義。
然而,在實際工作中,文件在編制和使用中存在著許多問 題,有待於解決。軟體開發人員中較普遍地存在著對編制文件不感 興趣的現象。從使用者方面看,他們又常常抱怨:文件售價太高、文 檔不夠完整、文件編寫得不好、文件已經陳舊或是文件太多,難於 使用等等。究竟應該怎樣要求它,文件應該寫哪些,說明什麼問 題,起什麼作用?這裡將給出簡要的介紹。
圖 文件橋梁作用
文件在軟體開發人員、軟體管理人員、維護人員、使用者以及計 算機之間的多種橋梁作用可從圖9.2中看出。軟體開發人員在各 個階段中以文件作為前階段工作成果的體現和後階段工作的依 據,這個作用是顯而易見的。軟體開發過程中軟體開發人員需制定 一些工作計畫或工作報告,這些計畫和報告都要提供給管理人員, 並得到必要的支援。管理人員則可通過這些文件了解軟體開發項 目安排、進度、資源使用和成果等。軟體開發人員需為使用者了解軟 件的使用、操作和維護提供詳細的資料,我們稱此為使用者文件。以 上三種文件構成了軟體文件的主要部分。我們把這三種文件所包 括的內容列在圖6中。其中列舉了十三個文件,這裡對它們作 一些簡要說明:
上述十三個文件都在一定程度上回答了這六個方面的問題。這可從表中看到。
表 文件所回答的問題
所提問題
文件 什麼
何處 何時
誰 如何
為何 可行性研究報告
√
√
專案開發計畫
√
√
√
軟體需求說明
√
√
資料要求說明
√
√
概要設計說明
√
詳細設計說明
√
測試計畫
√
√
√
使用者手冊
√
操作手冊
√
測試分析報告
√
開發進度月報
√
√
專案開發總結
√
維護修改建議
√
√
√
至此,我們對文件的作用有了進一步的理解。每乙個文件的任 務也是明確的,任何乙個文件都此是多餘的。
文件的作用和分類
文件的作用和分類 軟體文件 document 也稱檔案,通常指的是一些記錄的資料 和資料 它具有固定不變的形式,可被人和計算機閱讀。它和 電腦程式共同構成了能完成特定功能的計算機軟體 有人把源 程式也當作文件的一部分 我們知道,硬體產品和產品資料在整 個生產過程中都是有形可見的,軟體生產則有很大不同...
文件的作用和分類
自標準化資訊網 2003年04月21日 軟體文件 document 也稱檔案,通常指的是一些記錄的資料 和資料 它具有固定不變的形式,可被人和計算機閱讀。它和 電腦程式共同構成了能完成特定功能的計算機軟體 有人把源 程式也當作文件的一部分 我們知道,硬體產品和產品資料在整 個生產過程中都是有形可見的...
軟體文件的作用和分類
1 什麼是文件 文件 document 是指某種資料 和其中所記錄的資料。它具有永久性,並可以由人或機器閱讀,通常僅用於描述人工可讀的東西。在軟體工程中,文件常常用來表示對活動 需求 過程或結果進行描述 定義 規定 報告或認證的任何書面或圖示的資訊。它們描述和規定了軟 件設計和實現的細節,說明使用軟...