[转载]好教程的反例

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

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

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


1 概念不清

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

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

2 逻辑混乱

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

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

3 详细程度乱套

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

4 条目混乱

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

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

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

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

5 不会告诉你从哪里来

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

6 不会告诉你哪里更好

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

7 享乐倾向

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

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

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


结局

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

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

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

时间: 2024-11-12 20:54:05

[转载]好教程的反例的相关文章

(转载)Ant教程

ant教程(一) 写在所有之前 为了减少阅读的厌烦,我会使用尽量少的文字,尽量明白的表达我的意思,尽我所能吧.作为一个学习者,在我的文章中会存在各种问题,希望热心人指正.目录大概是这样 ant教程 (二) ant介绍 1,什么是ant ant是构建工具2,什么是构建 概念到处可查到,形象来说,你要把代码从某个地方拿来,编译,再拷贝到某个地方去等等操作,当然不仅与此,但是主要用来干这个3,ant的好处 跨平台  --因为ant是使用java实现的,所以它跨平台 使用简单--与ant的兄弟make比

[转载] FreeMarker教程

转载自http://www.blogjava.net/freeman1984/archive/2010/11/04/337239.html FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写 FreeMarker被设计用来生成HTML Web页面,特别是基于MVC模式的应用程序 虽然FreeMarker具有一些编程的能力,但通常由Java程序准备要显示的数据,由FreeMarker生成页面,通过模板显示准备的数据(如下图) FreeMarker不是一个We

[转载]CSS教程--字体与文本属性

b>font-family功能:用于改变HTML标志或元素的字体,你可设置一个可用字体清单.浏览器由前向后选用字体.语法:{font-family:字体1,字体2, ... ,字体n} font-style 功能:使文本显示为扁斜体或斜体等表示强调 .数值:normal - 正常italic - 斜体oblique - 偏斜体 font-variant 功能:用于在正常与小型大写字母字体间切换.数值:normal - 如果该标志继承父元素的 small-caps 设置,则关键字 normal 将

[转载]CSS教程:实例讲解定位Position

http://www.missyuan.com/thread-395406-1-1.html 1. position:static 所有元素的默认定位都是:position:static,这意味着元素没有被定位,而且在文档中出现在它应该在的位置. 一般来说,不用指定 position:static,除非想要覆盖之前设置的定位. #div-1 { position:static; } 2. position:relative 如果设定 position:relative,就可以使用 top,bot

虚拟机安装archLinux+xfce桌面教程(更新时间2017-5-8)

本教程转自http://blog.sina.com.cn/u/5692023517 感谢大神写出如此详细的教程并允许转载 本教程的目的:为了让新手安装arch不再那么难, 一个好的教程可以少走很多弯路 教程使用的软件:vmware workstation 12.5.5,virtualbox 5.1.20 - 镜像:archlinux-2017.05.01-x86_64.iso 安装环境为BIOS + MBR 效果图: 基本知识:需要懂一点nano 或 vim的使用方法 其他的可以看 arch w

Debian操作系统(安装教程,以及我遇到的问题)

安装虚拟机,安装完虚拟机如果要再安装系统,则要先进入电脑bios设置 Configuration 向下移动到Intel Virtualization Technology 设置为Enabled 这两个链接都是安装debian的教程 http://www.jb51.net/os/85858.html  转载其他教程, http://www.jb51.net/os/Ubuntu/473418.html, u盘启动盘的制作: http://blog.csdn.net/u012401034/articl

jdk8新特性

jAVA8 十大新特性 投稿:junjie 字体:[增加 减小] 类型:转载 本教程将Java8的新特新逐一列出,并将使用简单的代码示例来指导你如何使用默认接口方法,lambda表达式,方法引用以及多重Annotation,之后你将会学到最新的API上的改进,比如流,函数式接口,Map以及全新的日期API "Java is still not dead-and people are starting to figure that out." 本教程将用带注释的简单代码来描述新特性,你将

JDK各个版本的新特性jdk1.5-jdk8

JDK各个版本的新特性 对于很多刚接触java语言的初学者来说,要了解一门语言,最好的方式就是要能从基础的版本进行了解,升级的过程,以及升级的新特性,这样才能循序渐进的学好一门语言.今天先为大家介绍一下JDK1.5版本到JDK1.7版本的特性.希望能给予帮助. JDK1.5新特性: 1.自动装箱与拆箱: 自动装箱的过程:每当需要一种类型的对象时,这种基本类型就自动地封装到与它相同类型的包装中. 自动拆箱的过程:每当需要一个值时,被装箱对象中的值就被自动地提取出来,没必要再去调用intValue(

JDK1.5-1.8各版本新特性

JDK各个版本的新特性 对于很多刚接触java语言的初学者来说,要了解一门语言,最好的方式就是要能从基础的版本进行了解,升级的过程,以及升级的新特性,这样才能循序渐进的学好一门语言.今天先为大家介绍一下JDK1.5版本到JDK1.7版本的特性.希望能给予帮助. JDK1.5新特性: 1.自动装箱与拆箱: 自动装箱的过程:每当需要一种类型的对象时,这种基本类型就自动地封装到与它相同类型的包装中. 自动拆箱的过程:每当需要一个值时,被装箱对象中的值就被自动地提取出来,没必要再去调用intValue(