2008年5月25日 星期日

Q02 產出驗收文件(1)──建立系統執行環境的安裝手冊

系統要能驗收,首先要做的當然是得讓系統可以啟動,能夠啟動需要的是準備、安裝、與啟動。作法都是依步驟順序記錄成文字搭配抓圖,就可以讓使用者直接依照內容操作並驗證結果;必要的話甚至可將安裝的過程錄製為影像檔比對操作。

準備的意義在於告知使用者軟硬體的限制以及需要預先做好的事情,安裝是告知使用者怎麼將系統放置到他的電腦裡,啟動則是讓使用者知道如何執行整個系統的進入點。使用者依照手冊進行這些動作並正常地執行系統,之後才能夠依照使用手冊的內容進行各項功能。

在維護的場合,我們同樣需要建立一份開發環境的安裝手冊,讓接手的人知道怎麼從無到有地建立起原始程式的工作區。裡面除了需記載安裝的步驟外,每個使用的Library出處及版本,還有最新版本程式碼check out與check in的地方也需要詳細地記錄。當然也要包括如何產出系統執行檔案的說明。

以設計的角度來看,使用、開發與維護的這些動作每一個都是目的,針對完成這個目的都需要一連串的流程、動作與例外處理,也就是需要一份說明文件。用這樣的思維去看待那些動作,自然會明白一切的需要都是很合理的。

沒有留言:

張貼留言