原文來自:51Testing軟件測試網采編 ? ?作者:?仙靈測試(sinablog) ? ? ??原文鏈接:http://www.51testing.com/html/61/n-237961.html
?
1、文檔的種類
● 聯機幫助文檔或用戶手冊
這是人們最容易想到的文檔。用戶手冊是隨軟件發布而印制的小冊子,通常是簡單的軟件使用入門指導書。而詳細的幫助指導內容通常以聯機幫助文檔的形式出現,有索引和搜索功能,用戶可以方便、快捷地查找所需信息。Microsoft Word的聯機幫助文檔內容非常全面。多數情況下聯機幫助文檔已成為軟件的一部分,有時也在網站上發布。
● 指南和向導
是程序和文檔融合在一起形成的,可以引導用戶一步一步完成任務的一種工具,如Microsoft Office助手。
● 安裝、設置指南
簡單的可以是一頁紙,復雜的可以是一本手冊。
● 示例及模板
例如,某些系統提供給用戶填寫的表單模板。
● 錯誤提示信息
常常被忽略,但確屬于文檔。一個較特殊的例子,服務器系統運行時檢測到系統資源達到臨界值或受到攻擊時,給管理員發送的警告郵件。
● 用于演示的圖像和聲音。
● 授權/注冊登記表及用戶許可協議。
● 軟件的包裝、廣告宣傳材料
有些用戶會認真對待,并很好地利用它,因為錯誤或缺少必要的信息可能帶來麻煩。甚至標簽上的信息等均為文檔測試的內容。
2、文檔測試的重要性
對于用戶來說,軟件文檔是軟件的一部分,所以文檔的錯誤也是軟件缺陷。錯誤的解釋可能會引導用戶無法完成某些軟件已具有的功能。如果安裝文檔不正確,用戶無法進行安裝,肯定是軟件的bug。
好的文檔能達到提高易用性、提高可靠性、降低技術支持費用的目的,從而提高了產品的整體質量。用戶通過文檔可以掌握具體的使用方法,這提高了產品的易用性,避免了用戶在摸索使用中一些不可預期的操作,也就相對避免了一些不可預期的錯誤的發生,從而提高了產品的可靠性。當用戶在遇到問題時,多數會向朋友或同事詢問解決方法,再就是通過幫助文檔或請求公司幫助。約30%的用戶通過文檔解決了問題,也就避免了公司提供費用不菲的技術支持。
3、怎樣進行文檔測試
非代碼的文檔測試主要檢查文檔的正確性、完備性和可理解性。軟件驅動的文檔還得像程序一樣運行測試。
正確性是指不要把軟件的功能和操作寫錯,也不允許文檔內容前后矛盾。
完備性是指文檔不可以“虎頭蛇尾”,更不許漏掉關鍵內容。文檔中很多內容對開發者可能是“顯然”的,但對用戶而言不見得都是“顯然”的。
文檔要讓大眾用戶看得懂,能理解。術語、縮寫用戶是否理解?內容和主題是否一致?
很多程序員能編寫出好程序,卻寫不出清晰的文檔。與文檔作者密切合作,對文檔仔細閱讀,跟隨每個步驟,檢查每個圖形,嘗試每個示例是進行文檔測試的基本方法。