別耍流氓,什麼樣的教程才算是合格的教程

xiasf發表於2016-10-13

現在網路發達,網上資料多,查閱方便,所以網上學習的確是一種很好的途徑,但是網上的資料很多都呈碎片化的,並且質量良莠不齊,有的還有時效性,錯誤性等問題。很多原因往往給學習者帶來很大的困擾,下面就總結git學習的一些心得。(其實不光對於git學習,相信對於所有的學習都是這樣的。)

很多文章,教程,文件的作者希望將知識以通俗易懂的方式展現給讀者,儘量降低讀者的學習成本,使其更快的入門,所以就出現了很多的快速入門,速成等一些東西,在這裡我並不是說這些不好,我也曾讀過好多這樣的,並且也讓我掌握了一些技能,但是我想說的是,正是這些經歷和過程,讓我夜意識到一些問題,一些帶給我困擾甚至痛苦的問題,所以我才將這些當做心得寫出來。

比如廖雪峰的git教程吧(抱歉,原諒我拿廖老師的教程來舉例),花上一點時間,跟著作者的腳步,感覺很快就能掌握合併提交等操作,看似基本學會了git的使用,但是很多原理性的東西都講得不詳細,一語帶過,好多命令也只是例子中用到時出現一次,下次再出現不同的用法時又不知道怎麼用了,只能跟著作者的思路,完全是照著作者設定好的場景重現,脫離例子還是不會,這樣就算入門了麼?

我覺得不算,這樣的教程只算是讓讀者快速的瞭解git的基本作用,快速的概覽而已,在我看來這根本算不上是教程,這樣的東西看起來是快速入門,但對於想學好用入到實際工作中的同學,和沒有看過其他詳細文件的同學來說,這簡直就是從《入門到放棄》啊。

並且這對讀者產生很大的困惑,讓人感覺就是跟著作者的思路,用到的命令讀者也瞭解不全,反正就是跟著作者的思路,都用到了哪些命令,以及命令的作用,只知道片面的,不全,當脫離作者的腳步後,完全不會,更別說實際工作了。這是很多教程的通病。

這些教程可能想為了降低初學者的學習門檻,所以遮蔽掉很多細節的問題,遮蔽掉很多的知識,但是這樣殘缺的知識,讓初學者怎麼吸收呢,只能讓人感嘆,“啊,大神厲害啊,我完全不會啊!”,對於很多初學者來說,能輕鬆入門當然是好事,可是知識這麼嚴肅的事情,對於偏執狂來說,找不到一個命令的完全手冊來說都很痛苦,在面對片面的知識碎片時又該如何去整理呢?出教程的大神往往都達到了精通的級別,並且知識面全,所以寫起來,列舉的例子都很得心應手,有舉例參考價值,但是初學者根本就沒有大神這樣的水平,沒有全的知識面,所以在面對這樣精簡的知識碎片時又如何學習呢,不是笑話嗎?

我非常厭惡知識面不全,並且也沒有引導到其它完整資料的文章和教程。

這樣的教程要麼純屬裝逼,要麼就是弄巧成拙,反而害了初學者,本來想講得通俗易懂,降低學習門檻,但是卻為學習者後面的學習帶來了種種困難。—— 教程應該是授人以漁,而不是授人以魚。

我認為一個好的教程,文件講得通俗易懂當然是極好的,但是僅停留在通俗易懂的層面那就是耍流氓了,否則就請你給出其它詳細的文件,以幫助讀者繼續學習,並且建議讀者閱讀以全面學習掌握,除此之外還要在醒目的位置提醒讀者,讀你的教程並不能幫助讀者全面的進行學習,不能代替權威文件之類的提示。

綜上,一個好的教程應該是通俗易懂,由淺入深,全面詳盡的展示知識內容,展現出全面的知識輪廓、知識體系,以及學習該教程所需要的知識水平,並且給出建議,和學習其它知識的渠道。即使受篇幅限制,有時不能詳盡,也要引出其他資料,以完整的闡述知識。比如命令一定要講全,即使不全也要給出可供讀者檢視的完整手冊地址,並且文中如有引自其它地方的內容也要給出原地址,在必要的情況下面還可以給出對讀者有幫助的其他資料,書籍等。這才是對讀者,對知識負責任的態度。

大家有什麼想法或者補充歡迎留言^_^

相關文章