全文共1570字，預計學習時長4分鐘
我從事軟體開發行業已經有段時間了，見證了不同的項目以及團隊合作和招聘新人的方式。白板面試的問題仍存在爭議，但理想的面試方案尚未找到。這種類型的面試無法發現工程師其它的技能——這些技能通常被低估，但是能給團隊帶來很多好處。其中有一項對工程師尤為重要，雖然它常常被忽視。
所以它是什麼呢？是寫作技能。
我們花了大量的時間來學習如何成為一個更好的編碼員，但沒有將足夠的時間用在寫作和交流上。很多人都認為，這些技能雖然能夠決定職業的發展，但是很難與軟體開發聯繫在一起。
寫作需要構造結構並組織想法，一篇好的文章能夠將思路清晰地展現給每個人。本文所講的是為公司編寫技術文檔和技術文章。例如，思考一下最近產品進程中新開發出的功能，並嘗試描述清楚它。從用戶的角度去描述它的外觀以及可起到的作用，接下來添加技術的實施方式，使內容能清晰地呈現給隊友和CTO。
大多數工程師都不能成功完成這項任務。他們會重新思考來進行第二次嘗試，過段時間再給出新版的文檔，但這遠遠不能被稱為好的文章。這說明開發人員通常沒有做好解釋的準備。
這是可以理解的。作為開發人員，我花了大部分的時間寫代碼、看技術文檔，掌握解釋的能力不是我日常職責的一部分。
然而，如今的行業正在發生變化，工程師需要更多地參與產品的構建。這種工作方式需要給非技術性的同事解釋技術細節，清晰表達自己的觀點是必備技能。一個好的開發者可以作為中間人，向團隊的其他參與者解釋技術細節。
而寫作有助於這一點。長期練習寫作能使傳遞的信息易於接收。從事寫作的機會有很多，包括明確用戶故事、描述公司實時通訊的最新變化，以及在個人博客中展現對最喜愛的開源庫的想法。
要成為一個好的作者，你必須進行大量寫作，熟能生巧。但做到這一點還遠遠不夠，這裡列舉了一些可以改進技術博客文章的方法。
閱讀
請開始更多地閱讀你所在領域中其他作者的文章。這樣不僅能獲取信息，還能學習寫作的結構。每個作者都有自己的寫作風格和面向的讀者，你需要探索自己的寫作方式。如果寫作的風格還沒有形成，可以先嘗試使用幾種，熟悉現有的樣式是至關重要的。
反饋
不要害怕反饋。來自同事和朋友的建設性反饋有助你從不同的角度看待文章，要試著理解每條反饋背後的原因。你不必處理每一條反饋，但是通過分析學到東西是值得的。就如Frank A. Clark曾經所說：「批評就像雨水，能夠溫和地滋養一個人的成長，卻不破壞他的根基。」
讀者
在開始寫作前，要先思考目標讀者。寫關於時尚和生活方式的內容與寫技術內容是不同的，為團隊寫作與為老闆寫作也是不同的。內容不應遵循相似的目的，也不能以同樣的方式呈現。
同樣地，如果是篇技術教程指南，就應該考慮讀者的經驗水平。領域中的初學者總是對學習新事物感到興奮，但是經驗豐富的工程師可能不會對其有深刻的印象。要思考清楚文章的目的是什麼，讓每個人都滿意是不可能的，要試著關注目標人群，並為其編寫最合適的內容。
成為一個更好的工程師的方式有很多。向公司的其他員工和客戶解釋解決方案是最有價值的軟技能，你可以通過寫作來獲取這個技能。
留言點讚關注
我們一起分享AI學習與發展的乾貨
如轉載，請後臺留言，遵守轉載規範