原文: Developers: The Why and How to Writing Technical Articles

我在一个由200多名开发人员组成的Whatsapp群中发布了一个小广播,说多发表一些技术文章的必要性。群里的回复给了我写这篇短文的灵感。我发现很多开发人员不重视写作,我觉得这是不对的。

就像我知道很多开发人员不会写技术文章一样,我决定在广播最后补充如下文字。令我惊讶的是,有几个开发人员给我发消息说对于如何开始写文章,他们还需要帮助。所以我决定写这篇快速上手文章。

如果你想要让更多Medium用户看到你的技术类文章,可直接与我联系。提供一下你的Medium用户名并附上一篇或多篇文章链接。
如果你想开始写技术博文,却不知如何入手,也可以直接与我联系。

首先,要写出优质的内容需要付出很多努力。我知道这也是让许多开发人员放弃写作的原因。不过,在这篇文章的第一部分,我会先来说说写技术博文的好处。

创建自己的作品集

写技术博文的一个关键好处是它可以帮助你构建开发人员作品集。并且,它让你有充分的机会向他人展示你的工作技能。

另一点我认为对像Prosper Otemuyiwa这类开发人员有益的事就是无论所写教程长短,保证自己所做的事有意义。

帮助新人

你曾从他人的视频和文章受益才达到现在这个状态。这个理由足够促使你也写一些内容来帮助更多的人。

懂得更多

针对某一特定主题,你写得越多,或者说你教得越多,你就会越精通。你写的技术内容可能是关于如何搭建一个应用程序。因为你自己在构建过程中费了点劲,你希望所写文章可以帮助其他开发人员少走弯路。或者你写的技术内容是你刚学会的一个新东西,你想让全世界都知道你学会了什么。

做好上述事项,有助于你对自己的知识体系建立信心。

赚钱

是啊!钱非常重要,你坐着不动或者不做点对他人有帮助的事情,是不可能获得金钱的。你可以通过写技术内容获得报酬。只是在获得报酬之前,你必须先写出一些有趣的内容作为样本。

我知道有一些公司会为技术写作付费。一家是Scotch Development。并不是因为他们有更多的资金可以浪费,而是因为他们相信如果有正确的内容指导,开发工作会容易得多。

增加浏览量

文章有浏览量也是令我兴奋的一件事。我曾写过关于 React、Babel、webpack 和 Webpack 3.0 的文章,然后Codementor在Twitter上提醒我,浏览量达2000了。我开始为自己感到骄傲。

我认为有人阅读和学习你的内容,对你来说应该是个好事。

获得有限的机会

愿意投入时间来写技术文章的人很少。当有很多人申请某个东西时,有写作优势的人更有机会申请成功。

Auth0开放了他们的Web应用程序便于用户申请为Auth0大使。申请的条目之一是用户可以附上所写文章链接。这你应该有印象吧

我应该如何开始写作

每次我谈到写技术文章时,都会有人问我这个问题。在这篇文章中,我将根据我的经验和我读过的其它同类文章,来讲讲如何开始写作。

  1. 相信你可以

你不必以世界顶级开发人员的水平来要求自己写作。你可以就你当前正在学习的内容来写文章。

但首先是要相信自己可以写作。

2. 千里之行始于足下

许多开发人员对此感到困惑,因为他们会想“他们可以写些什么让人印象深刻的内容呢?”但是我总是说“从小处着手”。

我在媒体上发布的第一篇博文是PHP: BEYOND BUILDING WEBSITES。它不算是一篇真正的“技术”类文章。我写这篇文章只是为了输出一些东西,读者对文章的推荐又鼓励了我。随后我受邀成为一家媒体刊物上的一名作者。

这是我迈出的一小步。现在我在Scotch DevelopmentCodementorMedium@dev.to等平台上发布了更多的教程。

你也试试吧。

3. 学习新技术

寻找写作素材的最佳方法是学习新技术。可以学习没人要求你学习的新框架,然后着手写作。

最近,我看到一个新的JavaScript框架,却没看到关于这个框架的任何教程。在我翻阅这个框架的文档时,发现这个框架轻量又好用。

所以,我做了相关教程。一些活跃的JavaScript Twitter用户看到我的文章后不断转发,文章就获得了更多的浏览量。

4. 主题就在你身边

有些开发人员认为主题是主要问题。其实不是的。内容质量才是最重要的。你只需要保持敏锐。

我知道Scotch Development网站有一个版块,你可以去那里找找灵感,看看可以写些什么教程。点击此处查看。

基本上,主题没有什么新的。大多数时候,都是内容上有些差异。

  1. 知道你的利基(定位)

要在技术文章写作方面取得成功,你必须找准自己的定位。如果你知道自己在构建Web应用程序方面很厉害,就坚持写这方面的文章。同样,如果是在移动开发、人工智能、机器学习等方面很厉害,就坚持写这些方面的文章。

因为如果你在编写教程时犯了不该犯的错,读者会把你当成迷糊粗心的人。

6. 独特的写作方式

在写作时,你必须尽可能写得简单且让人读着轻松。就像是在向另一个开发人员解释一样写作,你要用简单的术语就能让他们理解。

你可以插入一些有趣的GIF图片、短视频、屏幕截图等等,吸引读者注意力。

  1. 获取反馈

兄弟姐妹们,不要以为自己什么都懂!那样只会是搬起石头砸自己的脚。征求意见,对于批评意见持开放态度,因为批评在所难免。

读者有一些不清楚的事情时,保证他们能够通过邮件或Twitter与你探讨。

8. 别停止写作

我本不该加最后这一点,但是还是想说,一旦开始,即使受到一些无端批评,也不要停止写作。

认真修改每一篇文章,勤加写作,终会有收获。

总结

我相信你一定从我这篇简短但真挚的文章中有所收获。欢迎你在Twitter@goodnesskayode上与我分享你的想法。

如果你能在Scotch.ioCodementorLinkedInDev.to阅读我的文章,我也会非常高兴。