2009年5月25日 星期一

V18 修改的追溯(1)──修改處的註解與收集程式

一個系統上的問題通常會在問題單系統裡建立一張問題單並給予一個編號,程式人員會針對解決這個問題而修改一些程式碼。以往的作法是填寫一份問題報告,描述問題的產出與解法,並記錄改了哪些程式;程式部分也另外填寫到一份release notes等到要上新的版本時,可以知道共有哪些程式需要更換。

版本-問題單-修改的程式是除錯與維護時物件的關聯,其中最基本的是問題單與修改程式間的關係。假設有一張問題單單號1234的錯誤在於初始值給錯,那麼就用根據本章前面所提的註解原則來修改程式並填寫註解。
  /*
   * 記錄索引的變數給予初值.
   */
  // index = -1; /* IR=1234 */
  index = 0; /* IR=1234 */

原則固定之後,註解處理工具就需要多設計一個程式來收集這些資訊。從最底層起要做的事有:
●每個Method裡為了每張問題單所修改的全部程式碼。
●每個Method內處理過的問題單集合。(回填到Method註解)
●每個Class內處理過的問題單集合。(回填到Class註解)
●每個Component內處理過的問題單集合。(回填到Component Interface註解)
●每個Package、Project直到workspace內處理過的問題單集合。(回填到對應的註解說明)

確認每個階層可以收集到所有填寫的修改註解,同時更新到Method、Class的註解裡是這個階段所要達成的目標。

沒有留言:

張貼留言