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

作者 | 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 在物联网中的巨大潜能。

扫描下方二维码，即刻免费报名！

 热 文 推 荐 

5G 时代连接 70 亿人，安全如何保障？

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

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

漫画：码一代是如何培养码二代的？

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

同样是消息队列，Kafka凭什么速度那么快？

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

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

她说：程序员离开电脑就是 “废物” ！

点击阅读原文，立刻报名 5G 沙龙。

你点的每个“在看”，我都认真当成了喜欢