从这个网站开始,或者说,从我的 IT 职业生涯开始,我就一直在思考这个问题?
「什么样的教程,才是好的教程?」
以前,我一直觉得,一个好的教程,首先要教会的是正确的东西。
直到后来,我发现,错了,错了,「正确的东西」这是基础,是不容置疑的存在,如果连 「正确东西」都做不到,那就不是教程,那就不要帮助别人,而是误导别人。
因此,在 「正确的东西」 的基础上,我们才有资格谈什么是好的教程。
经过不断的写,不断的尝试,不断的带其它人,我认为,一个好的教程,需要而且只需要三个步骤
-
人文关怀
教程作者懂的东西,学习教程的人不一定懂,一个高手,对待一个新人,要有耐心
-
简单易懂
更简单更傻瓜更愚蠢
这个可以说比人文关怀更重要,简单傻瓜化,那么新手在学习的时候才会觉得没有任何压力,才能循序渐进的慢慢学习
否则,一上来就是复杂的,一坨一坨的代码,谁看得懂啊。
-
循序渐进
为了简单易懂,教程开始的时候,可以选择性的忽略一些细节,一些解释
甚至为了简单,可以隐藏作出一些结果是正确的,但逻辑上是错误的代码。
但这并不推崇
新手,入门的,为什么要选择去培训学校,为什么要选择从视频开始,就是因为,它们需要百分之百的模仿,代码一字一句的复原。唯有这样,他们才会感觉是安全的。
目前尚无回复