### 学习总结 — 我们需要什么的阅读？ >[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