关于文档的问题

有这样一句话——程序员最讨厌两件事：别人不看文档和看文档。

事实就是这样，其实我们开发中遇到的大多数问题都是在文档中有解释的，但是总有人懒得看，希望别人直接告诉答案。但是不看文档导致的结果就是遇到同一个问题总是问，时间久了就导致很多程序员对于别人的问题喜欢直接甩出去一个文档了事。因为授人以鱼不如授人以渔，如果文档不理解再讨论相关的地方是更加高效和合理的解决方式。

在这里我们分析下这个行为，直接甩一个文档是不是好的解决方式呢？甚至我在知乎上看到过这样的一个问题——为什么程序员都这么高冷，不喜欢解答别人的问题。

事实上从我的生涯来看，大部分程序员还是很喜欢帮别人解答问题的，前提是这个问题有思考性。思考性是什么意思呢？就是这个问题并不是简单的一个API就能解决的问题，而是有实际的场景，然后并不是烂大街，百度一搜解决方案一大堆的。这样的问题比较复杂，会有人思考并给出解决方案的，而且很多人喜欢给出解决方案，而不是写好代码直接给，或许会写一些伪代码。因为写好代码需要的时间精力是伪代码的好几倍，在素不相识的前提下很少有人直接把完整的代码给出来的，当然有时候也有热心的人会给出来，不过很多时候还要考虑现实业务，所以很多时候是想给也没办法给。

其实我一开始做程序员的时候也不喜欢照着文档来学，因为太官方，太抽象，在不了解其理念的时候即使跟着教程敲了几遍代码也还是不明所以。但是慢慢的我发现了一个问题就是，其实很多所谓的教程也知识官方文档的摘抄加上一点自己的理解，甚至有些连自己的理解都没有，只是看着少了点，比起文档的长篇大论更容易看下去而已。而文档才是最新的一手资料，虽然描述方式很官方，那是因为文档必须要有自己的严谨性很准确性，所以使用到的术语比较多。

所以在理解一个框架、方案之后，其实看官方文档比大部分教程都有用，因为那些全是这些的总结，而总结的再好，终究是别人的，靠自己领悟到才能更加深刻的理解。

然后我这里稍微吐槽下关于百度和Google，百度大部分时候出来前几条是教程，而Google则是文档，比如我前几条搜索react hooks，第一条就是react hooks文档，而百度前几条都是菜鸟教程、一些教程等。（本来想用node stream做例子的，但是发现百度出来也是node中文网，故作罢）