1 为什么来写教程

最近已经“停更了很久”,其实并不是没有写,而是转头去写教程了,这个是我一直想做而又没有去做的事情。

为什么要去写教程。其实写文章,以如何挣钱为目的就是转化为以如何获取流量为目的,

SRE实战 互联网时代守护先锋,助力企业售后服务体系运筹帷幄!一键直达领取阿里云限量特价优惠。

那么最好的方式就是追踪热点,造焦虑,谈心得等等。

但是转念想来,这些东西并不能为别人带来实际的好处,实际上,大部分文章都是泛泛而谈。所以我觉得还是务实点号,去谢谢教程。虽然没有什么流量,但是至少还像那么回事。可以给需要的人一些可参看的东西。

 

2 那么如何写好教程?

所谓学习容易,教人难。很多东西,我自己用的时候,调试出一些结果就沾沾自喜,觉得很简单嘛,但是当我自己要求自己写一篇技术文章给别人学习的时候,懵逼了。啥也写不出来。而且很多知识点,自己什么都不懂。

 

2.1 态度很重要

谈到如何写好教程,我觉得首先得谈谈你对写教程这件事情的态度。教程,特别是给别人做示范的东西,一定要严谨,不能有问题。可以说每一个写教程的人都是一名老师,为人师表是每个人的心中责任。

比如,教程中的示例,一定能编译,一定要说明其编译的环境。我经常去下一些代码,结果到处是错误。浪费太多时间。

 

2.2 简明

我一直觉得如何讲明白一件事情,以最小的时间代价,是最为重要的。我认为比较优秀的教程,已经不是长篇累牍,不是照搬英文字面意思,而是经过深思熟虑后的写出来的。能够让读者一看就明白原理,以写就知道应用效果。但,实际上这对于写文章的人来说是最难的。

如果换到10几年前,如果你写本书只有几十页,能卖几个钱,而那些很多书一出来就是几百页。他们有什么不同,对读的人来说真的有用?

 

2.3 图文集合

能用一张图说明的,就不要用几段文字去详解。这样没有太大的意义。

能用一个流程说明全部问题,则不需要分散的图片去说明问题

 

2.4 善于终结

在文章开头说明知识点,学习的目的,学习需要的前提条件,在文章结尾要总结,要留有一定的作业式的悬念。

 

3 总结

总的来说,一篇教程,可能并不能另读他的人都满意,但应该是符合大部分人预期。

1)首先它必须是正确的

2)其次它必须易于阅读和理解

扫码关注我们
微信号:SRE实战
拒绝背锅 运筹帷幄