Oasis's Cloud

一个人的首要责任,就是要有雄心。雄心是一种高尚的激情,它可以采取多种合理的形式。
—— 《一个数学家的辩白》

如何撰写开发人员喜欢阅读的文章

作者:oasis


如何撰写开发人员喜欢阅读的文章

从读者角度来看文章,他们主要考虑两个问题:

  • 作者是为我这样的人(或者遇到某种问题)写的文章吗?
  • 阅读它能对我有何益处?

从作者角度来说,要写好标题,第一段就能回答作者关切的两个问题。

  • 读者可以在工作或个人生活中应用的一种技巧。
  • 对影响读者工作或个人生活的概念进行清晰的解释。
  • 让读者更好地理解特定技术或行业的见解。
  • 一个有趣的故事,引起读者的共鸣。

例子:

如果有的话,想要:编写更好的 Go 测试的简单方法

有一个很棒的 Go 测试模式,但知道的人太少了。我可以在 30 秒内教会你。

作者是为我这样的人写这篇文章的吗?

本文面向 Go 开发人员。

读了它有什么好处?

您将在 30 秒内学习一种新的测试技术。

当你写一篇文章时,你最好先考虑一下读者的类型。

在开始写作之前,先想清楚读者如何找到你的文章。