资讯专栏INFORMATION COLUMN

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

Blackjun / 1509人阅读

摘要:综上,一个好的教程应该是通俗易懂,由浅入深,全面详尽的展示知识内容,展现出全面的知识轮廓知识体系,以及学习该教程所需要的知识水平,并且给出建议,和学习其它知识的渠道。这才是对读者,对知识负责任的态度。

现在网络发达,网上资料多,查阅方便,所以网上学习的确是一种很好的途径,但是网上的资料很多都呈碎片化的,并且质量良莠不齐,有的还有时效性,错误性等问题。很多原因往往给学习者带来很大的困扰,下面就总结git学习的一些心得。(其实不光对于git学习,相信对于所有的学习都是这样的。)

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

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

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

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

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

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

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

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

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

大家有什么想法或者补充欢迎留言^_^

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/21938.html

相关文章

  • 26自学转行前端(写给和1年前一样迷茫你)

    摘要:转行前端有哪些疑虑在人生的抉择处,寻求一些别人的经验和总结,无可厚非,但是决定了就一定要坚定的走下去,谨慎是为了更好的坚持,而不是放弃的理由。写在前面这里前后端指的是开发的前后端。 转行前端有哪些疑虑? 在人生的抉择处,寻求一些别人的经验和总结,无可厚非,但是决定了就一定要坚定的走下去,谨慎是为了更好的坚持,而不是放弃的理由。写在前面:这里前后端指的是web开发的前后端。1、前端岗位需...

    番茄西红柿 评论0 收藏2637
  • 26自学转行前端(写给和1年前一样迷茫你)

    摘要:转行前端有哪些疑虑在人生的抉择处,寻求一些别人的经验和总结,无可厚非,但是决定了就一定要坚定的走下去,谨慎是为了更好的坚持,而不是放弃的理由。写在前面这里前后端指的是开发的前后端。 转行前端有哪些疑虑? 在人生的抉择处,寻求一些别人的经验和总结,无可厚非,但是决定了就一定要坚定的走下去,谨慎是为了更好的坚持,而不是放弃的理由。写在前面:这里前后端指的是web开发的前后端。1、前端岗位需...

    番茄西红柿 评论0 收藏2577
  • 26自学转行前端(写给和1年前一样迷茫你)

    摘要:转行前端有哪些疑虑在人生的抉择处,寻求一些别人的经验和总结,无可厚非,但是决定了就一定要坚定的走下去,谨慎是为了更好的坚持,而不是放弃的理由。写在前面这里前后端指的是开发的前后端。 转行前端有哪些疑虑? 在人生的抉择处,寻求一些别人的经验和总结,无可厚非,但是决定了就一定要坚定的走下去,谨慎是为了更好的坚持,而不是放弃的理由。写在前面:这里前后端指的是web开发的前后端。1、前端岗位需...

    番茄西红柿 评论0 收藏0
  • 成为一个合格前端正确姿势

    摘要:首先我们先搞清一个问题,学会的标准是什么我认为编程是一项技能,而不是知识。这个是学习提高最快的部分。所以一定要重视。 showImg(https://segmentfault.com/img/bVbhJ0v?w=450&h=260); 很多学生经历过这样的学习阶段: 1.看网上的视频教程 2.照着敲 3.学完了一个觉得自己还没学会 4.在学另外一个教程 5.感觉自己学会了 6.找个项目...

    red_bricks 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<