用户手冊

編寫內容要求如下。 ^[1] 

(1)引言

①編寫目的：闡明編寫手冊的目的，指明讀者對象。

②項目背景：説明項目的來源、委託單位、開發單位及主管部門。

③定義：列出手冊中用到的專門術語定義和縮寫詞的原意。

④參考資料：列出這些資料的作者、標題、編號、發表日期、出版單位或資料來源，包括項目的計劃任務書，合同或批文；項目開發計劃；需求規格説明書；概要設計説明書；詳細設計説明書；測試計劃；手冊中引用的其他資料、採用的軟件工程標準或軟件工程規範。

(2)軟件概述

①目標。

②功能。

③性能。包括數據精確度(包括輸入、輸出及處理數據的精度)，時間特性(如響應時間、處理時間、數據傳輸時間等)，靈活性(在操作方式、運行環境需做某些變更時軟件的適應能力)。

(3)運行環境

①硬件：列出軟件系統運行時所需的硬件最小配置，如計算機型號、主存容量；外存儲器、媒體、記錄格式、設備型號及數量；輸入、輸出設備；數據傳輸設備及數據轉換設備的型號及數量。

②支持軟件：操作系統名稱及版本號；語言編譯系統的名稱及版本號；數據庫管理系統的名稱及版本號；其他必要的支持軟件。

(4)使用説明

①安裝和初始化：給出程序的存儲形式、操作命令、反饋信息及其含義、表明安裝完成的測試實例以及安裝所需的軟件開發工具等。

②輸入：給出輸入數據或參數的要求。

③輸出：給出每項輸出數據的説明。

④出錯和恢復：出錯信息及其含義、用户應採取的措施，如修改、恢復、再啓動等。

⑤求助查詢：説明如何操作。

(5)運行説明

①運行表：列出每種可能的運行情況，説明其運行目的。

②運行步驟：按順序説明每種運行的步驟，應包括運行控制；操作信息(運行目的、操作要求、啓動方法、預計運行時間、操作命令格式及説明、其他事項)；輸入/輸出文件(給出建立和更新文件的有關信息，如文件的名稱及編號、記錄媒體、存留的目錄、文件的支配[説明確定保留文件或廢棄文件的準則，分發文件的對象，佔用硬件的優先級及保密控制等])；啓動或恢復過程。

(6)非常規過程：提供應急或非常規操作的必要信息及操作步驟，如出錯處理操作、向後備系統切換操作以及維護人員須知的操作和注意事項。

(7)操作命令一覽表：按字母順序逐個列出全部操作命令的格式、功能及參數説明。

(8)程序文件(或命令文件)和數據文件一覽表：按文件名字母順序或按功能與模塊分類順序逐個列出文件名稱、標識符及説明。

(9)用户操作舉例。

用户手冊是用户文檔中最重要的一部分，下面詳細介紹用户手冊測試的要點。 ^[2] 

1．用户手冊的完整性

重點考察用户手冊內容的全面性與完整性，從總體上把握用户手冊的質量。這一項看似簡單，但在實際測試中很多開發者還是無法做到這一基本標準。很多軟件由於開發過於倉促，在付諸使用時，用户手冊中缺少關於某些模塊的説明，讓用户使用起來比較困難。優秀的用户手冊內容應該是包括軟件的所有功能模塊。

2．用户手冊的描述與軟件實際功能的一致性

考察用户手冊與軟件實際功能的一致程度。當確認用户手冊基本完整後，還要注意用户手冊與實際功能描述是否一致。這種問題往往是由於用户手冊跟不上軟件版本的更新速度造成的。對用户來説，容易造成對描述不一致的功能的誤解和疑惑，進而影響用户對軟件的使用。優秀的用户手冊應該根據軟件的升級而及時更新，手冊描述應該與軟件實際功能保持一致。

3．用户手冊的易理解性

考察用户手冊對關鍵、重要的操作有無圖文説明，文字、圖表是否易於理解。對於關鍵、重要的操作僅僅只有文字説明肯定是不夠的，應該附以圖表使説明更為直觀、明瞭。優秀的用户手冊應該是圖文並舉，易於理解。

4．用户手冊提供學習操作的實例

考察對主要功能和關鍵操作提供的應用實例是否豐富，提供的實例描述是否詳細。當前大量軟件的用户手冊只有簡單的圖文説明，而無應用實例。這樣的用户手冊看起來就像是軟件界面的簡單複製，對於用户來説，實際上沒有什麼幫助。例如財務軟件，用户手冊就應該提供具體建賬實例及具體賬務處理的實例，這樣才能使用户看完用户手冊後，能夠獨立完成新賬簿的建立並逐漸學會使用軟件處理賬務信息。優秀的用户手冊不僅要對主要功能和關鍵操作提供應用實例，而且對實例的描述應做到詳細、充分，易於用户理解。

5．用户手冊的印刷與包裝質量

考察用户手冊包裝的商品化程度，印刷質量。有些用户手冊是簡單打印、裝訂而成，過於粗糙，不易於用户保存。優秀的用户手冊應提供商品化包裝，並且印刷精美。

在對用户手冊進行測試時，應該拿着它坐在計算機前，認真的進行如下操作。

(1)準確按照手冊描述使用程序。

(2)嘗試每一條建議。

(3)檢查每條陳述。

(4)查找容易誤導用户的內容。

案例：軟件產品“用户手冊”的標準檔案 ^[3]