E05 實作的記錄──寫下撰寫程式時的想法

不管是系統層面或是元件設計，設計的人都開立好每個層次的介面規格與類別名稱，實作的人只要依據類別、屬性與方法上的註解寫出符合規格的程式碼即可交差。表面上看起來似乎單調又無聊，但事實上要比表面上的有趣一點。

不管是在系統或是元件，設計的都只是框架與訊息呼叫的順序，實作的人需要用真實的程式碼來實現所有的功能。在使用其它公司提供的元件時，通常會有人先寫好prototype範例，實作時只要依照內容撰寫；但是prototype重視的只是功能的達成，在狀況的控制上相對地不夠週全。在設計時因沒有實際去做，光憑想像也無法妥善地控制好一切；這時就需要實作的人去補齊狀況的控管。

還有另一種情形是設計的人指定了要使用的其他元件，但是並沒有提供範例程式。這個時候實作的人就必須在設計的框架下，找出正常操作元件的確切方法並產生程式。即使只是依照邏輯撰寫程式時，也得依照專案規定，找出系統提供的底層API來呼叫以完成動作。

無論做了什麼動作，實作的人應該在程式之間夾上註解來說明當時的想法、作法、碰過的一些狀況與為何決定這樣實作的經過，往後接手或維護的人才能夠立即知道當初為什麼要這樣做。不用說也知道，當初我在維護系統時看到的鐵定是沒有註解的純粹程式碼，而且沒有人記得為什麼要那麼寫……。

◎系統的目標：