阅读更多技术类文章可以帮助你提升内容创作技能。方法如下。
由 Mux 主办的 DEV 全球展示挑战赛:展示你的项目!
我在《开发者内容创作指南》中给出的临别建议之一就是多阅读技术内容。阅读技术内容与学习写作同等重要,因为批判性阅读能够为开发者提供可应用于自身工作的工具。我们都能解释为什么不喜欢某篇文章或视频。但是,我们如何运用同样的洞察力去分析我们喜欢的东西呢?
阅读更多技术性内容不仅能丰富你的学习,还能为你提供不同的视角,并展示如何在保持自身独特风格的同时,有效地创作内容。创作高质量、受人喜爱的内容并没有唯一的“正确”方法。阅读来自不同来源的内容,会激发你在工作中采用更具创意的方法。
以下是一些你在阅读自己喜欢的内容时应该问自己的问题:
- 你为什么喜欢一篇技术文章? 2017 年,我做了一项针对使用 Bundler 的 Ruby 开发者的调查。调查的最后一个问题是请受访者分享一些拥有良好文档的开源项目示例。我问他们喜欢这些项目的原因。以下是一些回答:
“Elixir 的文档太棒了。我喜欢其中嵌入的示例和细节,以及指向 Erlang 文档的链接。”
“jekyllrb.com(文档分为多个部分,包含注释、提示和警告,最重要的是代码示例!!)。关键在于,拥有一个带有输出结果的代码示例(供参考)有助于更快地理解代码的功能。”
“Rails 和 Ember 的指南都很好地解释了框架所使用的概念,而不是它们各自的 API。”
这些开发者列举了一些优秀开源文档的特点。我利用这些反馈来识别和选择要分析的开源项目。我进行了竞品分析,了解每个项目的优势所在,并最终提炼出一些针对 Bundler 文档的建议,以提高文档的易用性。(我撰写了一篇关于我在 Bundler 网站上进行的审核以及如何利用调查结果改进文档页面的文章。)
-
他们的目标受众是谁?如果你要猜测目标读者是谁,他们了解什么,做什么,你会怎么说?你认为这些内容成功地触达了目标受众吗?如果是,为什么?
-
这家公司/个人最擅长的是什么?假设你订阅了一份每周都迫不及待想阅读的电子邮件简报。是什么让你一直订阅下去?你喜欢他们推荐的文章类型,还是他们运用幽默的方式?他们是否做了一些你在其他简报中从未见过的事情?优秀的内容创作者至少有一项技能特别突出,使他们脱颖而出。
-
这些内容对我有什么帮助?归根结底,技术内容的重点不在于创作者,而在于使用者。好的内容能帮助你达成目标,无论是学习新技能、理解新知识,还是从零开始构建项目。这些内容能帮你实现什么?它带给你怎样的感受?阅读起来是否令人沮丧?你是否喜欢阅读它?
-
实施“X”会如何改进我的内容?我们常常会借鉴别人的做法,比如:“我喜欢Sasha在邮件开头分享技术小贴士的方式;我也要这么做!”但我们这样做是希望它能帮助我们改进某些方面。你预期的结果是什么?在上面的例子中,你可能预期在自己的邮件中添加技术小贴士后,会有更多人点击邮件中的链接,或者会有更多人订阅。你预测会发生什么?这是你想要的结果吗?或者你实际上想实现的是其他目标?
既然你已经从成功因素的角度审视了这些内容,那就用更批判的眼光来审视它们吧。他们还能改进哪些方面,才能让这些内容更有效?完美的博客或简报并不存在。但内容可以(也确实)随着时间的推移而不断改进。
以下是一个以内容创作公司Mode Analytics为例的例子:
“Mode Analytics 公司制作免费的 SQL 教程。这些教程分为初级、中级和高级三个级别。每个级别都侧重于特定的命令,每个部分都包含示例和练习。”
这些教程写得非常好。我很喜欢跟着教程学习;入门教程的节奏把握得很好(不快不慢),内容完整,又没有过多细节,让我感觉自己很好地掌握了概念。
中级教程的节奏还有待改进。感觉有些步骤被跳过了;每次我对照正确答案检查自己的答案时,都发现我的答案总是漏掉一些东西,但我却不明白我是怎么得出正确答案的。节奏很难把握,我觉得我不得不参考其他资料才能更好地找出知识漏洞。
我之所以选择Mode的教程,是因为我想学习SQL。很多教程都教SQL,但我坚持学习Mode的教程,是因为它的节奏、结构和示例都让我受益匪浅,巩固了学习成果,而且不会让我感到沮丧。我很喜欢阅读他们的教程。
结论
总而言之,阅读技术内容不仅对提升技术技能至关重要,还能让你成为更优秀的内容创作者。阅读各种工程团队博客、开发者博客、新闻简报、文档、文章等等,能让你接触到不同的写作风格。以批判的眼光阅读技术内容,有助于你识别优质内容与低质量内容之间的区别,而这些区别反过来又能应用到你自己的作品中。
轮到你了:你遇到过哪些优秀的科技内容?它们为何如此有效?
我是 Stephanie,一名内容策略师和技术项目经理。访问developersguidetocontent.com了解更多关于我的工作!
文章来源:https://dev.to/radiomorillo/reading-more-technical-content-can-help-you-improve-your-content-creation-skills-here-s-how-j4k