为什么每个开发人员都应该练习写作

“未打开的书在铅笔旁边的特写照片” by Rawpixel在Unsplash上

作为软件开发人员,我们承担着各种各样的职责。 根据上下文,我们可以将大部分时间用于编写代码,也可以将大部分时间用于与客户一起处理功能请求。 有时,我们最终会编写自己的功能并进行测试,而我们是自己的系统管理员。 我们只能戴一顶帽子,也可以戴很多顶帽子。 但是无论我们承担什么责任,写作都是一项有用的技能。 无论您是要形成描述如何安装正在使用的Web服务的技术文档,还是要对客户的请求进行响应,都将具有良好的写作技巧。 但是就像任何技能一样,写作也需要实践和努力来积累。

没有良好的沟通能力,就不可能很好地开发软件。

用精确的语言表达技术细节或抽象概念并不是每个人都自然而然的事情。 这需要练习。 作为一种手艺,软件开发至少需要一些写作(很有可能需要很多写作)。 撰写有关概念的文章,甚至撰写有关系统的技术文章,都将改善并拓宽您对所撰写内容的了解。 为了向听众描述事物,您必须首先了解自己的意愿。 那么,有哪些方法可以提高写作技巧?

启动团队Wiki /博客:如果您的团队还没有Wiki,请启动一个。 在这里可以保存您创建的系统的技术实施细节。 您可以记录您的SDLC,并撰写有用的模式和概念。 不要害怕只是开始写作,并鼓励您的团队也这样做。

对新事物进行研究:选择您感兴趣但不是专家的设计模式或编程样式,进行研究,然后写下您的发现。 撰写不太熟悉的新事物是改善知识库并与团队甚至公开分享知识的好方法。 我喜欢写有关面向对象的设计模式的文章,例如Decorator模式,Adapter模式和Proxy模式。 如果有道理,您甚至可以包括一个示例存储库,以便您的读者可以跟随您的示例。

公开分享您的作品:与世界分享您的作品可能令人生畏。 我发现很难公开发表文章。 我倾向于认为人们不会对我要说的东西感兴趣,或者我正在写的东西是大多数开发人员都已经知道的东西。 可能是正确的,但还是要分享。 您永远不知道您可能会开始什么对话。 分享我的作品使我能够以前所未有的方式与人们联系。 使用Medium,共享您的写作从未如此简单。 (我现在正在接受自己的建议)

征求反馈:找到适合您的人,并请他们检查您的工作。 他们可能有您未曾想到的观点,并且可以为您提供更多的见解。 除了您的写作内容外,他们还可能对您的风格,语法或其他方面有想法。 但是请记住,写作在某种程度上是主观的,风格上的见解可能并不总是适用。 如果收到的反馈意见有些过分,只需感谢某人的想法,并在下次写信时考虑一下,以了解它是否适​​用于您。

不要停止:设定目标。 无论是中型帖子还是非公开Wiki文章,我都会至少每周写一次。 感觉好像不值得,特别是如果似乎没人在读您的著作时。 请记住,您正在为您做这件事,它使您成为更好的开发人员。