G23 驗收的文件(11)──系統開發教學

一般只提供使用的系統，交付安裝手冊與使用手冊後就可以過關。但是系統如果要交給客戶自己維護，甚至自行在系統上開發新功能時，那就得再交付一堆下述的文件才能過關。

首先要有開發環境的安裝手冊，包括開發伺服器的安裝、開發工作站的安裝，同時應該會需要安裝同步開發時控管的軟體。接下來要開發使用的工具軟體清單、安裝手冊與使用手冊，再來是如何建立原始程式工作區，如何使用同步控管軟體；以及前面提到的系統API參考手冊。

前面這一堆都還只是準備動作的文件而已，開發的重頭戲在於要怎麼教會使用者系統的精神、架構的意義，接著是一步一步地帶領使用者由淺入深地慢慢懂得如何使用API來組合成他們想要做的動作。之前為我維護的系統撰寫這一部分時，光是最上層開發或維護Use Case花了五天才寫出細節不夠完整的教學文件，講授時則是用了三天才講完較基礎的部分。

每一件想做的事物都必須投下相對的人力與時間，在此又是一個有力的印證。