640?wx_fmt=gif

良好的写作水平,是个被严重低估的软件工程师必备技能!

640?wx_fmt=jpeg

作者 | Gergely Orosz,软件工程经理

译者 | 弯月,责编 | 郭芮

出品 | CSDN(ID:CSDNnews)

以下为译文:

自从担任工程经理以来,我一直在努力指导几位经验丰富的软件工程师进一步发展专业水平。我注意到人们经常低估的一些重要的开发技能。这些技能可以显著提升开发人员的影响力,其中一项便是写作。

 

大多数软件工程师都会一心一意扑在写代码上——这种做法合情合理,这是在一定规模的团队中成为优秀工程师重要的一步。

 

然而,成功的公司会不断发展壮大,本来软件工程团队中的每个人都可以很方便地与其他人交谈,然而,团队迟早会多到几十个人,且有可能分散在不同的楼层,甚至在不同的地点开设新办事处,届时面对面的交流就不够了。而电子邮件、聊天或视频通话等渠道就会显得愈发重要了。这种增长的速度因公司而异:有些公司需要数年的时间;而对一些非常成功的公司来说,这个过程非常迅速。

 

在一个大型组织中,想要消息传递得更广,写作水平非常重要。

 

对于软件工程师而言,写作是与同行之外的工程师和团队进行联系、交流和影响的工具。为了让思想、权衡和决策带来更深远的影响,写作至关重要。你需要将这些想法写下来,以供各种各样的人阅读。需要持久保存的东西包括提案和决定、编程指南、最佳实践、学习、使用说明书、调试指南、事后调查,甚至还有代码审查。

 

为了让人们阅读你所写的文档,你需要良好的写作水平。如果文章的开头能够吸引人们的注意,那么他们会继续读下去,并领会到你想要传达的信息。很多人会对此做出回应,并且还不会对你的意思产生误解。如果你有良好的写作水平,就能够有效地与多个团队、组织或整个公司进行沟通。影响直属团队之外的能力是工程师进阶高级职位的基本技能——从高级工程师到组织的领导(不同的组织有不同叫法,例如首席工程师、管理层或杰出的工程师等)。

 

那么如何才能提高自己的写作能力呢?怎样才能写出清晰、简洁且易于阅读的文档呢?与每项技能一样,这是一个掌握基础知识、不断练习、获得反馈,然后再反复的过程。

 

在学习基础知识方面,你可以阅读很多书籍。我经常向工程师推荐两本入门的好书:

 

  • 《On Writing Well: The Classic Guide to Writing Nonfiction 》

  • 《The Sense of Style: The Thinking Person's Guide to Writing in the 21st Century》

 

在掌握了基础知识后,下一步是重新阅读自己写的文章,并不断重新编辑;站在读者的角度思考自己是否很快抓住了他们的注意力是关键;练习用较短的形式传递相同的信息,并反复重写信息的内容。

 

一些在线的服务能提供及时的反馈(https://www.grammarly.com/?affiliateNetwork=ho&affiliateID=42664&utm_source=program)。还有一种方式是向其他写作水平很高的人寻求邮件和文档的反馈。

 

我能给的建议十分有限。你也可以从别人那里吸取经验,比如目前Google工程高级副总裁UrsHölzle也说通过写作清晰地表达是工程师重要的技能。

 

工程师们经常会低估写作的重要性。投资这项技能,提升向其他人传达信息的能力,才能成为更有影响力的工程师。

 

链接:https://blog.pragmaticengineer.com/on-writing-well/

本文为 CSDN 翻译,转载请注明来源出处。

python学习路线图,人生苦短,快学Python

https://edu.csdn.net/topic/python115?utm_source=csdn_bw

 

【End】

CSDN 5G 免费沙龙来啦!

6 月 29 日,微软中国 CTO 韦青、北京邮电大学信息与通信工程学院多媒体技术教研中心主任/博士生导师孙松林、金山云 AIoT 事业部高级研发总监肖江、爱立信中国研发部多天线高级专家朱怀松、爱立信中国研发部主任系统工程师刘阳等行业内顶尖的领军者、资深的技术专家们共聚一堂,共同探讨 5G 在物联网中的巨大潜能。

扫描下方二维码,即刻免费报名!

640?wx_fmt=jpeg

 热 文 推 荐 

5G 时代连接 70 亿人,安全如何保障?

这位博士跑赢“地震波”:提前 10 秒预警宜宾地震!

所有的 iPhone 和高端 Android 设备都被破解了!

漫画:码一代是如何培养码二代的?

独家对话V神! 质疑之下的以太坊路在何方?

同样是消息队列,Kafka凭什么速度那么快?

50行Python代码教AI实现动作平衡

打破欧美垄断,国防科大斩获“航天界奥林匹克”大赛首冠

她说:程序员离开电脑就是 “废物” !

640?wx_fmt=gif点击阅读原文,立刻报名 5G 沙龙。

640?wx_fmt=png你点的每个“在看”,我都认真当成了喜欢

Logo

20年前,《新程序员》创刊时,我们的心愿是全面关注程序员成长,中国将拥有新一代世界级的程序员。20年后的今天,我们有了新的使命:助力中国IT技术人成长,成就一亿技术人!

更多推荐