全文共字,预计学习时长4分钟图源:unsplash我从事软件开发行业已经有段时间了,见证了不同的项目以及团队合作和招聘新人的方式。白板面试的问题仍存在争议,但理想的面试方案尚未找到。这种类型的面试无法发现工程师其它的技能——这些技能通常被低估,但是能给团队带来很多好处。其中有一项对工程师尤为重要,虽然它常常被忽视。所以它是什么呢?是写作技能。我们花了大量的时间来学习如何成为一个更好的编码员,但没有将足够的时间用在写作和交流上。很多人都认为,这些技能虽然能够决定职业的发展,但是很难与软件开发联系在一起。写作需要构造结构并组织想法,一篇好的文章能够将思路清晰地展现给每个人。本文所讲的是为公司编写技术文档和技术文章。例如,思考一下最近产品进程中新开发出的功能,并尝试描述清楚它。从用户的角度去描述它的外观以及可起到的作用,接下来添加技术的实施方式,使内容能清晰地呈现给队友和CTO。大多数工程师都不能成功完成这项任务。他们会重新思考来进行第二次尝试,过段时间再给出新版的文档,但这远远不能被称为好的文章。这说明开发人员通常没有做好解释的准备。这是可以理解的。作为开发人员,我花了大部分的时间写代码、看技术文档,掌握解释的能力不是我日常职责的一部分。然而,如今的行业正在发生变化,工程师需要更多地参与产品的构建。这种工作方式需要给非技术性的同事解释技术细节,清晰表达自己的观点是必备技能。一个好的开发者可以作为中间人,向团队的其他参与者解释技术细节。而写作有助于这一点。长期练习写作能使传递的信息易于接收。从事写作的机会有很多,包括明确用户故事、描述公司实时通讯的最新变化,以及在个人博客中展现对最喜爱的开源库的想法。要成为一个好的作者,你必须进行大量写作,熟能生巧。但做到这一点还远远不够,这里列举了一些可以改进技术博客文章的方法。图源:unsplash阅读请开始更多地阅读你所在领域中其他作者的文章。这样不仅能获取信息,还能学习写作的结构。每个作者都有自己的写作风格和面向的读者,你需要探索自己的写作方式。如果写作的风格还没有形成,可以先尝试使用几种,熟悉现有的样式是至关重要的。反馈不要害怕反馈。来自同事和朋友的建设性反馈有助你从不同的角度看待文章,要试着理解每条反馈背后的原因。你不必处理每一条反馈,但是通过分析学到东西是值得的。就如FrankA.Clark曾经所说:“批评就像雨水,能够温和地滋养一个人的成长,却不破坏他的根基。”读者在开始写作前,要先思考目标读者。写关于时尚和生活方式的内容与写技术内容是不同的,为团队写作与为老板写作也是不同的。内容不应遵循相似的目的,也不能以同样的方式呈现。同样地,如果是篇技术教程指南,就应该考虑读者的经验水平。领域中的初学者总是对学习新事物感到兴奋,但是经验丰富的工程师可能不会对其有深刻的印象。要思考清楚文章的目的是什么,让每个人都满意是不可能的,要试着