如何撰写工程博客

中等统计量(分钟)

我们于2015年11月启动了我们的工程博客。一年后,我们发表了50篇文章,并且在每个工作日平均吸引100位访问者。 是时候反思我们学到的东西了!

本文介绍了我们如何组织“工程博客”,如何花时间撰写文章以及什么样的故事吸引了最多的访问量。

1.专注于工程而非我们

从一开始,我们就决定启动与产品博客分开的工程博客。 事后看来,这是最好的决定之一!

不必担心产品或公司的直接品牌效应,使我们(作为开发人员)可以保持自己的地位。 我们只是为其他开发人员写一些我们想阅读的内容。

它尤其消除了过度抛光物品的必要性。 相反,我们可以像开发人员那样编写。 简而言之: 使用开发人员术语而不是试图赢得市场营销大奖!

有时,我们确实使用对自己产品的引用来说明这一点,但通常更喜欢使用读者已经熟悉的通用示例或开源产品。

我们的工程博客

2.将写作整合到开发工作流程中

聘请开发人员是因为他们擅长编写代码,而不是因为他们是热情的博客作者。 因此,要求开发人员在“有趣的主题”上写博客可能会造成很多开销和沮丧。

从“有趣的东西”到“无论如何我想分享”

最初,我们尝试了有关开放源代码和材料设计的更多文章。 撰写这些文章大约需要一天的时间-一周5天的时间太麻烦了。

因此,我们改变了方法。 我们没有写“有趣的话题”,而是开始写“我们现在正在做的有趣的事情”。 不久,我们又走了一步,写了“我现在正在做的有趣的事情-无论如何我想告诉我的同事”。

真实示例

一个很好的例子是我们如何在博客中介绍进入Polymer和Redux的世界-一个结合了两种流行技术的相当新的领域:

  1. 在弄清楚如何使这两种技术协同工作之后,我们写了一篇文章,介绍了基础知识。 本文主要针对我们的开发人员,但引起了其他人的极大兴趣。
  2. 关于如何使用选择器,我们遇到了一个特殊的问题。 我们写了一篇博客文章,总结了我们测试过的所有方法,并与社区共享以供讨论(我们得到了完美的解决方案作为回应)。
  3. 随着我们深入研究该技术,我们在博客中介绍了所遇到的各种问题。
  4. 一旦我们完全采用了新技术,我们就写了一篇有关如何正确重构代码的文章(它也充当内部文档)。

到那时,我们已经写了很多文章,以至于新开发人员无法吸收这些内容。 因此,我们创建了一个演示文稿,提供了整个故事。

幻灯片分享

最小化,最小化,最小化

我们还通过其他方式将每个开发人员的开销降至最低:

  • 在发布之前,开发人员不需要拥有某些“校对”文章。
  • 任何人都可以写一个别人想出的好故事/提示,但没有时间写。 这样就避免了“惩罚”开发人员提出创意的东西,无论他们是否愿意自己撰写,都可以独立进行。
  • 我们通常使用免费的闪烁图像来说明帖子(提醒您检查许可证并添加积分!)

3.专注于广泛关注的主题写作

在阐明了如何最大程度地减少写作开销之后,一个关键问题仍然存在:哪些主题值得博客关注?

让我们看一下我们最常阅读的文章的前10名(由Medium统计报告):

  1. 如何将私有存储库从Bitbucket移至Github(512位读者)
  2. Polymer喜欢Redux(500位读者)
  3. 科尔多瓦(Cordova)+ iOS 10:缺少NSCameraUsageDescription(441位读者)
  4. 如何使用Excel查看XLIFF文件(421个读者)
  5. 谁阻止了我的YouTube嵌入(Cordova / Phonegap)? (369位读者)
  6. 如何访问dom-repeat / dom-if中的动态创建的Polymer元素(364个读者)
  7. Polymer + Cordova iOS-速度提高80%(357位读者)
  8. 本地化Polymer应用程序(262个阅读器)
  9. 不要上当:铁器清单真的可以代替dom-repeat吗? (240位读者)
  10. 材料设计会带回黄金90年代吗? (231位读者)

这些帖子的阅读率从70%到90%不等。 例如:我们关于Bitbuckt到Github迁移的顶级文章吸引了689位观众,其中74%的人实际阅读了该文章(512位读者)。

中等统计

对前十名进行聚类揭示了一个有趣的模式:

  • 80%:迷你提示(操作方法,错误修复)
  • 20%:更广泛的话题

更令人震惊的是:尽管我们的博客主要是关于Polymer(一种前端技术),但在前5名帖子中只有一篇是关于Polymer的。 其他的则是使用了更广泛使用的技术,例如Bitbucket / Github,Cordova,XLIFF。

因此,如果以吸引流量为目标,那么: 最好的职位关注范围很窄,但是却引起广泛关注。

4.使用关键字丰富的标题

在讨论流量时,我们还分析了读者来自何处。

对于所有十大热门文章,Google吸引了80%以上的访问量,但有两个值得注意的例外:

  • 材料设计部分已由专门的聚合器链接。
  • Localize Polymer文章从其描述的开源项目上的链接中获得了大部分流量。

中等统计

带有关键字丰富标题(又名SEO友好)的文章的平均表现要比带有报纸标题的文章好得多,这不足为奇。

尽管以下带有报纸标题的文章具有相似的阅读比率,并从Twitter,LinkedIn和Medium获得相似的访问量,但与前十名文章相比,它们都缺乏Google的访问量:

  • 403:被CORS诅咒(22位读者)
  • 为什么Polymer会吃我的HTML标签? (52位读者)
  • 少(动画)多(50位读者)

即使是通常在数字媒体中表现出色的标题,也给我们带来了失败,例如3个不将App Translations与Formatting混合使用的原因(19个读者)。

因此: 不要对您的标题太有创意,而只需提及用户对其进行搜索的条款 。 对于重点狭窄的文章来说,这应该不难。

温馨提示:好的起点通常是您最初尝试在Google / Stackoverflow上寻找解决方案时使用的关键字。 如果您没有在合理的时间内找到结果,那么很可能其他人在寻找相同的关键字时可能会对您的解决方案感兴趣。

祝您博客愉快!

想更多地了解编码? 看看我们的其他 文章