刚从GReader别人的分享那里读了一篇文章《源代码有那么重要吗？》，有点小不爽，所以决定隔应下。

1, 关心文档而不关心代码才是本末倒置的，文档可以写的天花乱坠，吹的云里雾里的。但最终一个东西能否work，怎么样work，效率，安全，便利性。这些还是要靠code才能实现的。code都不敢给你，准备一大票文档来忽悠。这才是不可信的。计算机总归是一名科学，文档只不过是一种辅助的存在，code才是最本质的东西。谢谢。

2，至于说文档能告诉你一件事‘为什么’，而code只能告诉你‘如何’做。这更是逻辑混乱。因为文档的目的就是反映code的，所以文档能做到的事情，code一定也能做到。顶多是在告诉你‘为什么’这个事情上，文档如果在足够同步以及没有错误的情况下，比直接读code，可能要轻松一些。但是，谁能保证文档就一定是正确，如实的反映了你所用的code的真实行为呢。所以，如果想真的知道一个程序，一个库为什么这样那样，如何这样那样，读code还是最稳妥，最直接的。

3，没有文档是一件糟糕的事情，但是有文档，照着文档上的东西比划了半天，结果发现文档是错的。这是一件更糟糕的事情。就像一桌茶几。

4，维护旧的代码，有文档和没有第三方的代码，绝对比有第三方代码而没文档而更加糟糕。– 这个观点都不明白的人，肯定没有真正维护过，或者维护过足够多的旧的代码、系统。

5，流行的开源软件大部分都有很好的文档支持，一些存在文档不足的项目也都是在努力的补充文档（我还真没听说过某个open source project是抵制文档，已不写文档，不没有文档为荣的），而且我从来没见过哪怕一个开源爱好者说只喜欢没任何文档的open source project。所以，这位施主完全在真空中假设，然后得出一个谬论。

6，如果越来越的程序员，都觉得只要读些文档就好，连看点code的时间都不愿意拿出来，那才是整个行业的杯具。