文章开头怎么写?

file

每篇文章开头都必须有『简介』这个区块。

『简介』相当于是文章的地图,文章一开始的时候,我们先带读者看下地图,让他有一个大体的概念、给予他们正确的方向感,然后再带着他们一步步深入学习。

没有简介的教程文章,会导致读者迷失、体验下降、甚至丢失学习的信心,因此我们强制要求在每篇非『小结』的文章开头,都必须有『简介』区块。

下面讲解一个例子:

讲到异常时,一上来就是很直接的具体操作,有时候会让读者无所适从,如:

file

但是加上这一段,就会感觉温和很多:

file

一般简介的撰写思路是:

  1. 说明这篇文章里,我们要干嘛?简单介绍即可;
  2. 说明这篇文章里要做的事情,在整个课程或者项目里有什么作用?
  3. 分享一些开发的经验;
  4. 学习建议和指引。

以上只是提供一些思路,具体作者们可以自由发挥。只需遵照撰写『简介』的初衷即可 —— 为用户提供一张小地图,防止他迷路。

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
讨论数量: 0
发起讨论 只看当前版本


暂无话题~