星期二, 10月 05, 2004

文件的重要性

在 JAVA 的 Web 開發領域上,充滿著許許多多的 framework 可以使用,然而,對於每家公司而言,擁有一個屬於自己的 framework 更是重要,此 framework 可以架設在現有的 framework 之上,而其目的是為了更簡便的開發。

由 於此 framework 已經與原本的架構不一樣了,開發者當然可以很熟悉並快速的使用此 framework,但是對於新手而言,若缺乏人的指導,則必須自己慢慢去摸索,在現在資訊人員快速流動的情況下,交接也總是不清不楚的情況下,多人經手 之後,原本建立的 framework 慢慢的失去了原本的精神。讓最後接手的人,越來越難以消化。

當面臨此種狀況,第一,當然是抱怨。第二,迫於現實,還是得慢慢去摸索。第三,有心得了,反正大概知道怎麼改了,再多加一點架構來方便使用。

問題在於,一個人學會了東西以後,並不會去把它用文件的方式紀錄下來,原因是因為忙。沒錯,寫文件會花時間,但是一定是值得的。

我認為,一個好的技術人員,除了在技術方面有所成就之外,更重要的是,經驗的傳承。人的價值不在於他擁有了多少的核心技術,而在於經驗能否傳承,才是令人佩服的。
在經驗傳承中,若能一直教導別人當然是很好,但是若能以文件保留下來,則是更好的。因為文件的努力只是剛開頭的初期,文件有了,新人就可以自己去讀,去了解。省去了反覆問問題的時間。當新人看不懂,可以加強文件。

所以,如果是原創者,負責任的就要寫好文件說明,如果是接觸別人的架構,曾經困擾自己很久的,在知道以後,動手寫一份說明吧。

現在 Wiki 的觀念出現,就是因為文件的重要性,資訊會慢慢成長,文件也必須隨之更新。
做任何事,找替手先。是一個準則,所強調的觀念,也是經驗的傳承。

0 Comments:

張貼留言

<< Home