作为软件工程师,我竟然还需要有文笔?


全文共1570字,预计学习时长4分钟

图源:unsplash

我从事软件开发行业已经有段时间了,见证了不同的项目以及团队合作和招聘新人的方式。白板面试的问题仍存在争议,但理想的面试方案尚未找到。这种类型的面试无法发现工程师其它的技能——这些技能通常被低估,但是能给团队带来很多好处。其中有一项对工程师尤为重要,虽然它常常被忽视。

 

所以它是什么呢?是写作技能。

 

我们花了大量的时间来学习如何成为一个更好的编码员,但没有将足够的时间用在写作和交流上。很多人都认为,这些技能虽然能够决定职业的发展,但是很难与软件开发联系在一起。

 

写作需要构造结构并组织想法,一篇好的文章能够将思路清晰地展现给每个人。本文所讲的是为公司编写技术文档和技术文章。例如,思考一下最近产品进程中新开发出的功能,并尝试描述清楚它。从用户的角度去描述它的外观以及可起到的作用,接下来添加技术的实施方式,使内容能清晰地呈现给队友和CTO。

 

大多数工程师都不能成功完成这项任务。他们会重新思考来进行第二次尝试,过段时间再给出新版的文档,但这远远不能被称为好的文章。这说明开发人员通常没有做好解释的准备。

 

这是可以理解的。作为开发人员,我花了大部分的时间写代码、看技术文档,掌握解释的能力不是我日常职责的一部分。

 

然而,如今的行业正在发生变化,工程师需要更多地参与产品的构建。这种工作方式需要给非技术性的同事解释技术细节,清晰表达自己的观点是必备技能。一个好的开发者可以作为中间人,向团队的其他参与者解释技术细节。

而写作有助于这一点。长期练习写作能使传递的信息易于接收。从事写作的机会有很多,包括明确用户故事、描述公司实时通讯的最新变化,以及在个人博客中展现对最喜爱的开源库的想法。

 

要成为一个好的作者,你必须进行大量写作,熟能生巧。但做到这一点还远远不够,这里列举了一些可以改进技术博客文章的方法。

 

图源:unsplash

阅读

 

请开始更多地阅读你所在领域中其他作者的文章。这样不仅能获取信息,还能学习写作的结构。每个作者都有自己的写作风格和面向的读者,你需要探索自己的写作方式。如果写作的风格还没有形成,可以先尝试使用几种,熟悉现有的样式是至关重要的。

 

反馈

 

不要害怕反馈。来自同事和朋友的建设性反馈有助你从不同的角度看待文章,要试着理解每条反馈背后的原因。你不必处理每一条反馈,但是通过分析学到东西是值得的。就如Frank A. Clark曾经所说:“批评就像雨水,能够温和地滋养一个人的成长,却不破坏他的根基。”

 

读者

 

在开始写作前,要先思考目标读者。写关于时尚和生活方式的内容与写技术内容是不同的,为团队写作与为老板写作也是不同的。内容不应遵循相似的目的,也不能以同样的方式呈现。

 

同样地,如果是篇技术教程指南,就应该考虑读者的经验水平。领域中的初学者总是对学习新事物感到兴奋,但是经验丰富的工程师可能不会对其有深刻的印象。要思考清楚文章的目的是什么,让每个人都满意是不可能的,要试着关注目标人群,并为其编写最合适的内容。

 

成为一个更好的工程师的方式有很多。向公司的其他员工和客户解释解决方案是最有价值的软技能,你可以通过写作来获取这个技能。


推荐阅读专题

留言点赞发个朋友圈

我们一起分享AI学习与发展的干货

编译组:邓逸瑶、李紫瑶

相关链接:

https://medium.com/better-programming/writing-is-the-undervalued-skill-of-software-engineers-e2390275562b

如转载,请后台留言,遵守转载规范

推荐文章阅读

ACL2018论文集50篇解读

EMNLP2017论文集28篇论文解读

2018年AI三大顶会中国学术成果全链接

ACL2017论文集:34篇解读干货全在这里

10篇AAAI2017经典论文回顾

长按识别二维码可添加关注

读芯君爱你

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值