陳子軒站起來,向大家示意謝謝,然後輕輕坐下來,用平和的語氣,開始說。

“我這兩天,將公司有關電力企業乙太網軟體專案的原始碼案例,做了一些瞭解和查閱,發現裡面存在一些問題。雖然這些問題對於軟體的執行,不會有多大影響,但對我們公司內部的交流、溝通和工作的效率,卻有重要意義。首先是原始碼的註釋問題,我發現大部分的原始碼案例都沒有註釋語句……”

陳子軒侃侃而談,說了自己的一些看法,除了註釋語句問題,還有一些模組之間配合和效率問題,陳子軒建議軟體專案部的同事,都形成一個寫註釋語句的好習慣,這樣可以方便組與組之間,同事與同事之間,先寫者與後續者之間的瞭解溝通,提高程式碼的參考、修改和閱讀的效率。

曹經理一邊聽一邊點頭,他很認可陳子軒的想法和意見,這些做法對規範部門內部的管理,當然有著很大的幫助,但是底下的員工和有些主管,卻有著自己的想法。

“如果要寫詳細的註釋語句,勢必會加大我們的工作量,拖慢我們的工作進度,曹經理,真的有這個必要嗎?”底下有人說出自己的反對意見。

曹經理望了一下陳子軒,示意他來回答,也把這個皮球踢給了他。

陳子軒微笑著,說:“寫詳細的註釋語句,表面上看,的確增加了程式設計師的輸入工作,按正常的註釋密度來說,會增加5%左右的工作量和工作時間,但是這5%的工作時間,卻能為我們在修改、接手、學習、參考這些原始碼程式的時候,至少節省30%以上的時間!”

“有這麼誇張嗎?”有人說。

陳子軒望了那反對的人一眼,這個人剛才曹經理介紹時,好像還是一個主管。

陳子軒繼續說:“我這兩天,閱讀程式碼案例的時候,就有這個深刻的體會,原本我以為一天之內能看完的程式碼,我卻花了一天半的時間才看完。因為前面對一些定義和函式不瞭解,後面遇到的時候要翻回去看,有一些甚至要靠猜,所以無形之中,增加了我50%的工作量和時間,而如果有了註釋語句,我想這半天就可以省下來。”

陳子軒此話一出,底下的蓋書和楚利都露出不可思議的表情,他們最清楚,陳子軒拿去的程式碼案例有多少,那是一個正常程式設計師至少需要一個星期才能看完的,而且他們也知道沒有註釋語句,看起來時間會更長,每想到陳子軒竟然說他只用一天半的時間,已經把程式碼案例全部看完了!到底是吹的還是真的;他們不清楚,但從陳子軒之前提到的程式碼中的一些問題看,陳子軒的確是認真的看了這些程式碼案例的,而且有些問題,是必須全部看完才能發現的。

蓋書朝楚利吐吐舌頭,表示驚訝,楚利則悄悄伸出自己的大拇指,朝陳子軒指指,意思是這個人,牛!

聽完陳子軒的說明和解釋,底下也沒有人再反對,其實做程式設計師的都知道,陳子軒說的這些東西,都是對的,如果別人的程式碼註釋清晰明瞭,格式邏輯性強,那麼自己看起來當然又快又舒服,也很容易找到和修改BUG。但是人都有惰性,都是“寬於對己,嚴於對人”,自己在寫程式程式碼的時候,往往偷懶圖快,對於註釋,只要自己能看懂就行,能省則省,沒為別人去想過。接手程式的人一看,上一任寫程式碼的都沒有寫註釋,我幹嘛寫?於是形成惡性迴圈,大家都不寫,這樣接手的人遇到看不懂的地方,還得來問自己,更凸顯出自己的重要性。

陳子軒在會上,建議軟體專案部形成自己的程式程式碼編寫規則,大家都要按照規則的要求來寫註釋,形成制度,曹經理當場拍板,形成決議,以後軟體專案部的所有程式設計師,寫程式碼都必須遵守編寫規則,按要求寫好註釋。並讓陳子軒去把規則的具體細則列出來,交給他,他簽字認可以後就下發給部門所有