### 學習總結 — 我們需要什么的閱讀？ >[info] 現在網絡發達，網上資料多，查閱方便，所以網上學習的確是一種很好的途徑，但是網上的資料很多都呈碎片化的，并且質量良莠不齊，有的還有時效性，錯誤性等問題。很多原因往往給學習者帶來很大的困擾，下面就總結git學習的一些心得。（其實不光對于git學習，相信對于所有的學習都是這樣的。） 很多文章，教程，文檔的作者都希望將知識以通俗易懂的方式展現給讀者，盡量降低讀者的學習成本，使其更快的入門，所以就出現了很多的快速入門，速成等一些東西，在這里我并不是說這些不好，我也曾讀過好多這樣的，并且也讓我掌握了一些技能，但是我想說的是，正是這些經歷和過程，讓我也意識到一些問題，一些帶給我困擾甚至痛苦的問題，所以我才將這些當做心得寫出來。 比如廖雪峰的[git教程](http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000)吧（抱歉，原諒我拿廖老師的教程來舉例），花上一點時間，跟著作者的腳步，感覺很快就能掌握合并提交等操作，看似基本學會了git的使用，但是很多原理性的東西都講得不詳細，一語帶過，好多命令也只是例子中用到時出現一次，下次再出現不同的用法時又不知道怎么用了，只能跟著作者的思路，完全是照著作者設定好的場景重現，脫離例子還是不會，這樣就算入門了么？ 我覺得不算，這樣的教程只算是讓讀者快速的了解git的基本作用，快速的概覽而已，在我看來這根本算不上是教程，這樣的東西看起來是快速入門，但對于想學好并用入到實際工作中的同學，和沒有看過其它詳細文檔的同學來說，這簡直就是從《入門到放棄》啊。 并且這對讀者產生很大的困惑，讓人感覺就是跟著作者的思路，用到的命令讀者也了解不全，反正就是跟著作者的思路，都用到了哪些命令，以及命令的作用，只知道片面的，不全，當脫離作者的腳步后，完全不會，更別說實際工作了。這是網上很多教程的通病。 這些教程可能想為了降低初學者的學習門檻，所以就“避重就輕”（加個引號的意思是表示這里并沒有說作者只講容易的避開難的和質疑作者水平的意思，而是說很多的作者出的教程總按照自己的套路來，沒有意識到這樣教程是不合格的教程，和這樣做是不對的）地屏蔽掉很多細節的問題，屏蔽掉很多的知識，但是這樣殘缺的知識，讓初學者怎么吸收呢，只能讓人感嘆：“啊，大神厲害啊，我完全不會啊！”，對于很多初學者來說，能輕松入門當然是好事，可是知識這么嚴肅的事情，對于偏執狂來說，找不到一個命令的完全手冊來說都很痛苦，在面對片面的知識碎片時又該如何去整理呢？出教程的大神往往都達到了精通的級別，并且知識面全，所以寫起來，列舉的例子都很得心應手，有舉例參考價值，但是初學者根本就沒有大神這樣的水平，沒有那么全的知識面，所以在面對這樣精簡的知識碎片時又如何學習呢，不是笑話嗎？ 我非常厭惡知識面不全，并且也沒有引導到其它完整資料的文章和教程。 這些問題是目前網絡上很多教程的通病。 這樣的教程要么純屬裝逼，要么就是弄巧成拙，反而害了初學者，本來想講得通俗易懂，降低學習門檻，但是卻為學習者后面的學習帶來了種種困難。—— 教程應該是授人以漁，而不是授人以魚。 我認為一個好的教程，文檔講得通俗易懂當然是極好的，但是僅停留在通俗易懂的層面那就是耍流氓了，否則就請你給出其它詳細的文檔，以幫助讀者繼續學習，并且建議讀者閱讀以全面學習掌握，除此之外還要在醒目的位置提醒讀者，讀你的教程并不能幫助讀者全面的進行學習，不能代替權威文檔之類的提示。 綜上，一個好的教程應該是通俗易懂，由淺入深，全面詳盡的展示知識內容，展現出全面的知識輪廓、知識體系，以及學習該教程所需要的知識水平，并且給出建議，和學習其它知識的渠道。即使受篇幅限制，有時不能詳盡，也要引出其他資料，以完整的闡述知識。比如命令一定要講全，即使不全也要給出可供讀者查看的完整手冊地址，并且文中如有引自其它地方的內容也要給出原地址，在必要的情況下面還可以給出對讀者有幫助的其他資料，書籍等。這才是對讀者，對知識負責任的態度。 *（補充：最好還要有創作的背景，時間，以及一定要有所講技術的版本，因為技術更新非常快，如果沒有寫作時間和軟件版本，那么對以后的人閱讀那簡直是痛苦）* 無疑，《Pro Git》就是這樣一本書哦。 >[info] 只要是官方文檔都支持，好的文檔嚴謹細致，從學習者，使用者的角度探尋知識，阮一峰的文章大家都喜愛很重要的原因就是無論多么復雜的知識他講出來大家都懂，又不片面，知識點都覆蓋到了，講解和學習者的思維在一個步調上面，這樣的文章閱讀者能不接受嗎，好的文章，文檔，就像你的一位朋友，在跟你說著話一樣。它有一定的個性，風格，但講解知識時又保持著絕對的嚴謹，可靠，全面。這樣的文章，文檔是每個讀者想要的，讀到這樣的文章，文檔實在是一種莫大的幸福。 ### 再談學習方法 > 當學習一項知識技能時需要學習總結一些理論知識，做筆記，這些自己總結的理論有可能只對自己有用，但是這對于幫助我們學習，幫助理解有很大的作用，畢竟我們不是天才，智力也很普通，不是那些一看就會，快速就能完全領會的人，如果不靠這些來幫助我們理解，那我們是很難學習的。 下面將以"X"代指一項技能/技術/項目/軟件。 經過實踐總結出來的一些學習經驗： 1. X是什么，做什么的，全面了解一下，了解X是什么，什么背景下誕生的，是解決什么問題的。以及和它同類的產品，做對比，各自的發展如何，綜合全面的了解X。 2. 從一個通俗易懂的概覽快速的了解一下X如何解決問題的，以便后續學習，可以看看各種快速入門（但不要看多了哦）。 3. 做好筆記，收集詳細完整的文檔，完全手冊（特別是對于命令較多的項目最好有個完全手冊），最好是官方的。 4. 找到一個靠譜活躍的社區。 5. 當你做好了這些準備工作之后就開始實際動手編碼，鍛煉加深理解，并完全掌握，運用到實際工作中。 6. 不論何時不要忘記做筆記，特別是學習過程中舉例一個論證理論，然后證明，提出問題，直至解決，這些一定要記筆記，這樣才能完全理解，掌握。 >[danger] 學習一個東西時要學會歸納一些理論，并在學習過程要多做筆記，特別是不懂的地方要多做筆記，還要提出問題，然后深入思考這些問題，只有這樣才能舉一反三，最終完全掌握這項技術，并且還會有一些額外的收獲。 其實看起來和“望”（快速概覽），“聞”（深入了解），“問”（提出問題），“切”（實際動手）差不多。 ### 擴展 參考： - [技術的正宗與野路子](http://kb.cnblogs.com/page/554496/) - [中文技術文檔的寫作規范](http://www.ruanyifeng.com/blog/2016/10/document_style_guide.html) update：2017-3-8 10:50:17