公司內(nèi)部有這樣一句話:所有人都渴望有文檔,所有人都不喜歡寫文檔。深有體會深受其害。
文檔是沉淀,是歷史經(jīng)驗的總結(jié),是走過的路,埋過的坑。前幾年,包括現(xiàn)在,印度人的軟件工程很是厲害,review是他們的軟件質(zhì)量大法。而review的整個過程每一個細節(jié)都能在文檔上找到。和印度客戶打交道,除了咖喱味的英語難懂,還有就是驗收時各種文檔的打回重寫。不僅僅是印度人,東南亞的很多運營商,都十分重視文檔開發(fā)工作。
作為一個設備制造商,我們走出國門和曾經(jīng)的通信巨頭去pk,技術上并無差距,但在文檔領域,簡直弱爆。雖然現(xiàn)狀上那些曾經(jīng)風光的大公司如今合并得合并(例如阿爾卡特朗訊諾基亞),消失的消失(例如北電、摩托羅拉)勒緊褲帶過日子正在死扛(例如愛立信),但企業(yè)的文檔意識及文檔體系,我們相差的距離還是十分遙遠。
今天的想法是來自一個調(diào)了三天的部署環(huán)境的加班狗對于不嚴謹?shù)奈臋n的無力吐槽。想起來,工作文檔之外,人生的其他領域同樣需要review和過程文檔化。讓自己不斷總結(jié),再指導前行。
寫下來的意義就在于此吧……