別耍流氓，什麼樣的教程纔算是合格的教程

如今網絡發達，網上資料多，查閱方便，因此網上學習的確是一種很好的途徑，可是網上的資料不少都呈碎片化的，而且質量參差不齊，有的還有時效性，錯誤性等問題。不少緣由每每給學習者帶來很大的困擾，下面就總結git學習的一些心得。（其實不光對於git學習，相信對於全部的學習都是這樣的。）

不少文章，教程，文檔的做者但願將知識以通俗易懂的方式展示給讀者，儘可能下降讀者的學習成本，使其更快的入門，因此就出現了不少的快速入門，速成等一些東西，在這裏我並非說這些很差，我也曾讀過好多這樣的，而且也讓我掌握了一些技能，可是我想說的是，正是這些經歷和過程，讓我夜意識到一些問題，一些帶給我困擾甚至痛苦的問題，因此我纔將這些當作心得寫出來。

好比廖雪峯的git教程吧（抱歉，原諒我拿廖老師的教程來舉例），花上一點時間，跟着做者的腳步，感受很快就能掌握合併提交等操做，看似基本學會了git的使用，可是不少原理性的東西都講得不詳細，一語帶過，好多命令也只是例子中用到時出現一次，下次再出現不一樣的用法時又不知道怎麼用了，只能跟着做者的思路，徹底是照着做者設定好的場景重現，脫離例子仍是不會，這樣就算入門了麼？

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

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

這些教程可能想爲了下降初學者的學習門檻，因此屏蔽掉不少細節的問題，屏蔽掉不少的知識，可是這樣殘缺的知識，讓初學者怎麼吸取呢，只能讓人感嘆，「啊，大神厲害啊，我徹底不會啊！」，對於不少初學者來講，能輕鬆入門固然是好事，但是知識這麼嚴肅的事情，對於偏執狂來講，找不到一個命令的徹底手冊來講都很痛苦，在面對片面的知識碎片時又該如何去整理呢？出教程的大神每每都達到了精通的級別，而且知識面全，因此寫起來，列舉的例子都很駕輕就熟，有舉例參考價值，可是初學者根本就沒有大神這樣的水平，沒有全的知識面，因此在面對這樣精簡的知識碎片時又如何學習呢，不是笑話嗎？

我很是厭惡知識面不全，而且也沒有引導到其它完整資料的文章和教程。

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

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

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

你們有什麼想法或者補充歡迎留言^_^