提供介面供使用者互動的任何系統,通常都需要一般使用者輔助資料;主要部分內嵌且很少或完全沒有使用者介面的系統,即使可能適合且需要記載 API,也可能省略這個工作成果。
這個工作成果通常含括下列一或多個文件和工作成果:
-
使用手冊
-
操作手冊
-
維護手冊
-
線上示範程式
-
線上說明系統
-
上下文相關說明
-
版本注意事項
使用者文件提供軟體的使用指示。提供適用於所有使用者類型的文件。
以使用案例做為使用手冊的基準。
使用者手冊可能由技術文件撰寫人員根據開發人員的輸入來製作,或由測試團隊撰寫,此團隊的成員可能比較瞭解使用者的觀點。
將使用者手冊交由測試團隊來撰寫的理由在於可配合開發來同步產生,並儘早形成具體且相關的評估準則。使用者介面和使用者介面模型中的錯誤及不良的解決方案,可以在專案早期的反覆活動中及早發現並修正,因為此時變更的成本較低。
從撰寫使用者手冊的過程中,測試人員會愈來愈瞭解系統,最後才動手進行任何全面測試。再者,在測試計劃和測試案例及自動化測試套組上,也提供必要的建構基準。
在開發週期在早期,何時開始製作使用者手冊視系統類型而定。對於介面複雜或有大量使用者互動的系統,必須儘早開始製作使用者手冊,並及早建立介面的原型。人性介面較少的內嵌系統可能不需要太早開始製作使用者文件。
|