在工程師職場生涯中,有幾件事是工程師不想做,不喜歡做,或是不願意做,但現實卻逼得工程師不得不做的,『記錄』就是其中之一!
想像中的工程師應該是隨手寫好程式,轉頭丟給老闆,留下一句『我的工作完結了』的瀟灑身影,現實則是程式會隨著
『Bugs』~『老闆的意見』~『客戶的需求』~『市場的接受度』
等各種各樣的因素而進行修改及調整,修改的次數很容易讓工程師懷疑人生!特別是當你正在修Bug-0179,老闆突然問你Bug-0081,Bug-0121及Bug-0144修好沒.........你的腦袋閃過的是『那是啥』?這時候你就需要『記錄』來幫你回憶!
工程師產生或是接觸的記錄有很多種,但是記錄的主要用途其實很單純,就是幫助工程師能夠快速的回想起案子的細節,或者是協助新人盡快的熟悉正在進行的專案!
我曾經碰過一個案子,在我接手之前這個案子已經開發超過8年,系統版本已經到5.0,功能範圍涵蓋影像處理及錄影,GPS定位導航及軌跡追蹤,機械設備控制,與雲端後台系統的連線等等,而且......負責該案的工程師還有1個月就要走人!
因為是跨國公司,專案經理及工程師在加拿大,我們只能透過線上會議的方式進行交接,專案經理詳細的講解整個系統的架構,工程師也盡可能的帶過一輪程式碼說明,殘缺零散的專案開發記錄還是對我造成困擾,很多功能的設計邏輯我需要花時間從程式碼去反推,有些已經廢棄不用的功能模組,我也需要花時間去一一釐清,這種時間的花費其實是可以避免的.....如果當初他們有做『記錄』!
完善的『記錄』可以幫你輕鬆應對頑強的Bug,不聽話的系統,愛檢查的老闆,好奇心強的客戶,準備參與專案的新人,尤其是當你離職之後,大幅降低舊公司聯絡你的頻率!畢竟你知道的.....『好的前任就應該像死了一樣』!記得我離職之後,前公司唯一一次聯絡我是因為他們不小心刪掉我的工作交接記錄,打電話問我還有沒有備份!
既然『記錄』這麼有用,為什麼會說工程師不愛做記錄呢?主要的原因在於『時間』,專案的開發,維護,修改,更新都有限期(deadline),當工程師在限期之前必須靠加班才能完成工作時,老實說是沒有多少精力跟時間去做『記錄』!另外還有一個原因,就是『記錄沒有明顯與立即的價值感』!畢竟記錄是在需要用到的時候才有價值,沒用到就是一堆廢紙,而什麼時候會用到只有天曉得!
工程師需要做哪些記錄?該怎麼記錄?這個話題我們下一篇再來談!畢竟........『記錄』也是要花時間的!





















