程式碼與文字
題圖 from unsplash
程式碼與文字
做技術的,寫程式碼自然不在話下,但你說寫個設計文件、做個技術總結分享什麼的,可就把一部分人難倒了,理由是沒寫過、沒思路、寫不出來、文筆不行等等。當然不要抬槓:程式碼也是文字。
你是不是有這種情況?有沒有絞盡腦汁、硬著頭皮湊字交差的經歷?相信絕大部分技術朋友都有這樣的窘境吧!
先說回技術人之間的溝通問題,溝通分大類:口頭溝通和書面溝通,口頭溝通最常見的形式有電話交流,培訓交流,面對面討論,組織會議等。書面溝通形式有郵件、書面彙報、PPT、各種軟體文件等。口頭且面對面的交流溝通是效果最好的,但有個缺點:不能留存口頭討論的結果,事後不久就忘了當時討論的內容、結論等,基本無從追溯,特別當相關各方涉及利益問題時,免不了要有會議紀要,備忘錄、正式合作檔案等等。
理論上講程式碼邏輯寫的沒有問題,那你的文字的表達能力應該也沒有問題,唯一的原因大概只是欠缺訓練。分開講:訓,偏向於理論概念方向;練,偏向於實踐操作方向,兩者結合才能完美。文字都是抽象思維裡的具像化,並在具體的場景以不同的形式展現出來。想象一下,如果一個開源元件缺少文件的話,會是一種什麼狀態,還會流行嗎?除非很好用,自然會有人主動為其增加文件,來方便後來者學習掌握。如果程式碼裡沒有註釋,這對維護者簡單就是噩夢,所有需要有一些文字、圖表等等來方便人們更加快速的掌握其中的奧祕。
比如說去做軟體設計的過程中必然有一些核心或者是複雜度比較高的業務,必須付諸於圖、表或文字,來加速、加深干係人對它的掌握理解,以便於實際的編碼過程中保證業務不走樣。你是不是會遇到這樣的場景:去跟某個技術人員去交流學習某塊的業務,他讓你去看程式碼,理由裡程式碼裡寫的清清楚楚?如果是個不懂行的人跟你交流業務問題,還能程式碼來搪塞,估計要說不過去了。能用圖表說清楚的儘量不用文字,能用文字說清楚的儘量不依賴程式碼,形象化的東西總是容易被人記的深刻。
寫作技巧是有,簡單掌握下即可,其實程式設計師的日常文件也就那麼多,能表達意思即可。比如概設、詳設、儲存設計、核心流程圖、開發計劃、介面設計、架構設計、物理部署等等,完全可以數的過來。都說 寫程式碼的沒有寫PPT的薪水高 ,這是個表象,另一個層面也說明寫PPT更多的面向非技術人員去溝通交流,比如上級領導、老闆、客戶等等,另一個也說明人的資歷在提升,打交道的人際範圍在擴大。從業時間越久,越需要你一定的文字功底,不然跟多個干係人溝通起來都是問題。跟高層彙報總不能拿空口白牙大白話吧,跟兄弟們作分享,總不能拿程式碼比劃吧,去外面做技術交流,總不能打包IDE看程式碼吧。
說這麼多,主要是想傳遞一個訊號:不要逃避寫文件,何況很多都有參照模板,往裡套東西總不至於太難吧。寫文件有利於自我總結提煉、抽象提升、積累沉澱,加深對技術、對業務的理解,更有利於不同領域的人之間交流溝通,事後追溯查閱等等。其實所有這些,目標還是隻有一個:更高的提升自我,不管是薪水職位,還是個人成長。
寫文字的好處有很多,找一個點說服自己,行動起來。凡事,有必要的,都要學著來。
比如我寫文字可以找到志同道合的朋友,結交生活中不可能認識到的一些人,這就是寫公號文章的副產品,時間久了,能夠形成體系,更加的有價值。
往期推薦:
長按2秒,識別二維碼,關注我