别耍流氓,什么样的教程才算是合格的教程

如今网络发达,网上资料多,查阅方便,因此网上学习的确是一种很好的途径,可是网上的资料不少都呈碎片化的,而且质量参差不齐,有的还有时效性,错误性等问题。不少缘由每每给学习者带来很大的困扰,下面就总结git学习的一些心得。(其实不光对于git学习,相信对于全部的学习都是这样的。)git

不少文章,教程,文档的做者但愿将知识以通俗易懂的方式展示给读者,尽可能下降读者的学习成本,使其更快的入门,因此就出现了不少的快速入门,速成等一些东西,在这里我并非说这些很差,我也曾读过好多这样的,而且也让我掌握了一些技能,可是我想说的是,正是这些经历和过程,让我夜意识到一些问题,一些带给我困扰甚至痛苦的问题,因此我才将这些当作心得写出来。网络

好比廖雪峰的git教程吧(抱歉,原谅我拿廖老师的教程来举例),花上一点时间,跟着做者的脚步,感受很快就能掌握合并提交等操做,看似基本学会了git的使用,可是不少原理性的东西都讲得不详细,一语带过,好多命令也只是例子中用到时出现一次,下次再出现不一样的用法时又不知道怎么用了,只能跟着做者的思路,彻底是照着做者设定好的场景重现,脱离例子仍是不会,这样就算入门了么?学习

我以为不算,这样的教程只算是让读者快速的了解git的基本做用,快速的概览而已,在我看来这根本算不上是教程,这样的东西看起来是快速入门,但对于想学好用入到实际工做中的同窗,和没有看过其余详细文档的同窗来讲,这简直就是从《入门到放弃》啊。教程

而且这对读者产生很大的困惑,让人感受就是跟着做者的思路,用到的命令读者也了解不全,反正就是跟着做者的思路,都用到了哪些命令,以及命令的做用,只知道片面的,不全,当脱离做者的脚步后,彻底不会,更别说实际工做了。这是不少教程的通病。文档

这些教程可能想为了下降初学者的学习门槛,因此屏蔽掉不少细节的问题,屏蔽掉不少的知识,可是这样残缺的知识,让初学者怎么吸取呢,只能让人感叹,“啊,大神厉害啊,我彻底不会啊!”,对于不少初学者来讲,能轻松入门固然是好事,但是知识这么严肃的事情,对于偏执狂来讲,找不到一个命令的彻底手册来讲都很痛苦,在面对片面的知识碎片时又该如何去整理呢?出教程的大神每每都达到了精通的级别,而且知识面全,因此写起来,列举的例子都很驾轻就熟,有举例参考价值,可是初学者根本就没有大神这样的水平,没有全的知识面,因此在面对这样精简的知识碎片时又如何学习呢,不是笑话吗?get

我很是厌恶知识面不全,而且也没有引导到其它完整资料的文章和教程。it

这样的教程要么纯属装逼,要么就是弄巧成拙,反而害了初学者,原本想讲得通俗易懂,下降学习门槛,可是却为学习者后面的学习带来了种种困难。—— 教程应该是授人以渔,而不是授人以鱼。入门

我认为一个好的教程,文档讲得通俗易懂固然是极好的,可是仅停留在通俗易懂的层面那就是耍流氓了,不然就请你给出其它详细的文档,以帮助读者继续学习,而且建议读者阅读以全面学习掌握,除此以外还要在醒目的位置提醒读者,读你的教程并不能帮助读者全面的进行学习,不能代替权威文档之类的提示。原理

综上,一个好的教程应该是通俗易懂,由浅入深,全面详尽的展现知识内容,展示出全面的知识轮廓、知识体系,以及学习该教程所须要的知识水平,而且给出建议,和学习其它知识的渠道。即便受篇幅限制,有时不能详尽,也要引出其余资料,以完整的阐述知识。好比命令必定要讲全,即便不全也要给出可供读者查看的完整手册地址,而且文中若有引自其它地方的内容也要给出原地址,在必要的状况下面还能够给出对读者有帮助的其余资料,书籍等。这才是对读者,对知识负责任的态度。书籍

你们有什么想法或者补充欢迎留言^_^