0222 - 官方文档与第三方教程

技术的官方文档通常有个特点,或者说问题,就是太长太冗余。为了保持权威性和完整性,就像 RFC 一样,必需事无巨细地交待所有内容。这就使得 主要和次要的内容混杂在一起,既淹没了重点,也极大地增加了学习成本。

而与之相对的,是 现代人 的急躁;并不想真正地学习某东西,而只是想尽快解决眼下的问题。尤其是,老板怪不得员工在瞬间用新技术实现新业务。

两者对比如此强烈,怎么办呢?找捷径

这种状况和思路,是没有国别和文化差异的。体现在国内就是各种速成班(演化到现在就是网上课程、知识付费),XXX 简明教程,30 天 XXX 实战,给大忙人写的 XXX 入门教程,等等。在国外就是 Head First 系列等等。翻开这些书,绝大多数都是 LJ,通常是官方文档的整段整篇搬抄或翻译,都是在人们焦虑急迫之下的知识快销品。

当然,也不能一棒子打死,有些第三方教程或书籍,确实是很好的。比如,《Cocoa Programming for Mac OS X》,比如阮一峰老师的文章。在我看来,好的教程主要提供两方面的帮助:

  • 突出重点
    • 暂时隐藏不太需要知道的东西,降低学习成本
  • 提供视角
    • 从经验及实战的视角,重新组织知识

打个比方,官方文档平铺直叙,像个平面,像散落在地上的珍珠。好的教程,可以从中挑选中好的珍珠(重点部分),并用一根线(经验及实践的视角),把它们串起来、从地上拎起来,成为立体的东西。

只是,这样 好的教程,可遇不可求,尤其是知识快销品容易获利,而这样的教程既难制作、又极易被抄袭的时代。于是,更重要的,还是要 增强自己学习的能力

其实,现在 很多官方文档也提供了不同维度的介绍。既包含平铺化的 API 列表,也有 Excample 提供小而完整的示例,还有 Cookbook 对某些知识点进行深入讲解。善用这些内容,在不同阶段学习对应的东西,再辅以必要的练习,基本就可以很好地入门一些技术。

学习,没有捷径。即便现在貌似抄了近路,将来也是要还的。