H07 修改系統程式(4)──頭痛的問題

這個題目其實可以反過來問：修改系統程式時需要哪些資訊會感到輕鬆自在？以前面三個標題來看，大致上需要知道的資訊也有三種：原來的程式這樣寫的原因？新的功能要怎麼寫才能達成？還有程式修改下去會有什麼影響？

第一點需要的是程式碼裡包含足夠資訊的註解，有時會需要功能規格書甚至是原始需求資料；第二點需要的是API參考文件與系統開發教學文件；第三點需要的是程式對Use Case與Test Case的對應表，如此方能保證修改後的系統通過了所有相關的測試。

可以想像以上所有資料都殘缺不全時的景象，不是詢問原先的設計人員就是要自己從程式碼反推出那些文件裡應有的內容。問原設計者是最快的，但我的經驗在細節的部分以趨近100%的比例得到”已經太久以致忘記”的答案；也就是說，幾乎每個問題都得靠自己去反解譯程式才行。

由於自己走過才知道痛在哪裡，也因此自己在從事設計時都會特別注意要留下足夠讓別人明瞭或是換醒自己記憶的資訊；然而最理想的作法還是要留下足夠的完整資料才對。