zoukankan      html  css  js  c++  java
  • [转载]好教程的反例

    [转载自]好教程的反例 https://www.yayaus.com/

    我不知道怎么回事,好像国内写教程的绝大多数活跃用户都写的是些接近垃圾的东西,说好听点叫做无心之过,说难听点居心不良——他们就是在享受小白用户跪拜。

    我尝试列举下他们的教程的缺点,算是给自己敲下警钟。


    1 概念不清

    通常这些教程,乃至一个知名论坛对某些特定主题(例如wii硬件破解)的置顶新手须知,都缺乏对基本概念的解释。一来就是大堆的教程,简直让人怀疑 他们都是从天外飞来的高人,虽然不知道他们到底在对什么谈笑风生。阅读这些教程的人,不仅不知道他们在说什么,还很可能误解些什么,胆小的都不敢下手了, 浪费很多时间的同时更败坏心情。

    我们就是缺乏给出一个小册子的精神的样子。

    2 逻辑混乱

    一篇教程通常来说都有一个总体的逻辑的,整个教程都是总体逻辑的展开。它不仅能让人知道这是什么,还能知道为何如此,为何不如此,一步步的让人达成最终的目标。把基本的分析一番并不是要多详细的事情,但是据我的经验来看,那样的效果却好得出奇,我真的知道了我在干什么。

    坏的教程却是相反,更干脆的还有教程A让人先读B,B要先读C,C要先读A。

    3 详细程度乱套

    我们弄有的东西是需要知晓很多具体的细节的,这时候的教程有总体的逻辑有详细的分析说明就比较好。坏的的教程就颠倒过来,需要理解的,他就仅仅告诉你怎样做而不说原由,不需要理解的,却给读者扯一大通,看得我都没话讲了。

    4 条目混乱

    这个东西的名字我并没有想好。我是想表达几种这样的情景:

    一个教程所针对的对象,他有很多不同层面的东西,这些应当是至少有分开介绍的。比如说破解wii后的套路,至少也应该分开来,说明清楚吧。结果坏的教程,不同流派的方法全部混合到一起,根本不知道现在到底干了什么了。

    另外一种是,明明只需要一个最好的就能说清楚的,他们却推荐些一知半解的,互相有冲突的 ,有区别的,莫名其妙的东西给用户读,结果是大家看得云里雾里。这点例如国内的远景黑苹果论坛。

    还有一种,重复的。这有的是指一个东西明明一次就够了,他们却反复给出来浪费时间却不能弄出真正核心的东西(虽然重复也是掌握核心的一个方法,但我 不是指的此类)。另外一点其实是指的不少软件的说明书,你甚至能发现其中的手册介绍的东西竟然是重复的,但是你不知道其中的区别和用意,得到的是困惑。

    5 不会告诉你从哪里来

    我们很多的东西实际上并非这位写教程的实现的,但是他引用了非常多的内容,却不告诉你自己应当如何查找他们。结果,以后的人可能就成了亦步亦趋,不知举一反三的人,莫非那帮人就是这样给读者定位的?

    6 不会告诉你哪里更好

    如同商家不会告诉你他主推的商品谁买谁傻逼,论坛高人们通常也不会告诉你另外的论坛远远比这里好。

    7 享乐倾向

    这帮人手握核心却绝不将核心示人以后往往能得到两个奖励:别人对他的无比膜拜,他对别人的随意谩骂。

    这帮人动不动就告诉别人“先读菜鸟帖”“自己去看XX”,实际上看了这些也是个笑话,真正的核心却不在那些内容中。有的人就特别喜欢如此,对他人不友善,追着不能明白核心的人咬,动不动就要上升到侮辱对方人格的地步。

    我想这两种奖励就如同吸毒吧,他们离不开它们。


    结局

    观摩的人通常会有这样的感受——简单明确易用安全可靠都只是个笑话,只是传说中才会有的东西。

    如果同一个主题同时有外国(英文区)和港台讨论区并且都有一些人气,通常它们就是要比中国这边的讨论区质量更高,希望将来能更好吧。

    一篇好的教程,应该能具备以上坏处的反面,不过我的经验是,同时拥有多数错误比同时拥有多数优点容易多了。

  • 相关阅读:
    【SAS NOTE】OUTPUT
    【SAS NOTES】_NULL_
    【SAS NOTE】sas 9.2 安装
    【SAS NOTE】FREQ
    纯数学教程 Page 203 例XLI (1)
    纯数学教程 Page 203 例XLI (3)
    纯数学教程 Page 203 例XLI (2)
    Prove Cauchy's inequality by induction
    纯数学教程 Page 325 例LXVIII (15) 调和级数发散
    纯数学教程 Page 325 例LXVIII (15) 调和级数发散
  • 原文地址:https://www.cnblogs.com/wangzming/p/5929440.html
Copyright © 2011-2022 走看看