沉下心来,先把文档读了 -#48

在这个瞬息万变的时代,我们每天都在面对新的挑战和未知。对我来说,两次润的经历让我更加深刻地体会到面对新环境和未知,最有效的应对方式之一就是——读文档。

沉下心来,先把文档读了 -#48
Photo by Arisa Chattasa / Unsplash

在这个瞬息万变的时代,我们每天都在面对新的挑战和未知。对我来说,两次润的经历让我更加深刻地体会到面对新环境和未知,最有效的应对方式之一就是——读文档。

读文档是我们程序员的基本功,编程世界里 "read the fucking manual" 一直是反复被提到的。掌握一门新技术,或者说想真正理解一门新技术,最好的方法就是直接打开官网去读文档,而不是看别人的文章或教程。

自从搬到美国,每天都像是在进行一场新的探险。新的生活环境,新的生存法则,在两眼一摸黑的情况下,其实是很难真正快速了解并熟悉一个地方的规则的。我之前写过一篇博客 Three Levels of Information Perception,就是讲不同人对信息的感知程度是不同的。比如 401k 和医保,这两个在美国最常接触到的福利政策,却是很多人来了多年都不一定能解释清楚的,也是很多人听了很多讲解、看了很多文章也不一定理解的。

这一方面是因为,你作为信息接收者因为缺少太多的上下文而导致无法精准的问出自己的困惑;另一方面,输出者即使是一个能事无巨细给你讲清楚的人,也会出现信息的有损传播

我在学习 401k、医保、税收等政策时,也询问过很多同学,我发现了两个现象:

  • 太长不看。很多人可能也尝试去学习过,但发现官方给的文档都太长了,现代人一看大段文字就头晕眼花,遂放弃
  • 二手信息。很多人则是依赖于二手信息,比如他们会和我说直接去某红书上搜相关的帖子,很多人会总结的很好,他们甚至说不需要读文字,直接看图片里的关键字就行(可能这就是某红书火的原因?)。

我一直觉得看别人总结的,都是浮于表面的,就像看影视解说,5 分钟看完整个剧情梗概是永远没有完整地 2 小时看完全片来得震撼的。当然,我们不能否认别人的总结确实能给我们节省很多时间,让我们以更高效的方式去理解新事物,但涉及到一些具体细节的时候,仍是需要我们去原文档确认的(这里我不得不感叹一下美国很多部门的官网做的也太好了,比如 IRS)。再比如,很多同学买到新电器都是直接凭感觉就上手操作了,大多数情况是没什么问题的,但如果把说明书读一遍可能会收获很多更精妙的用法,也避免了因为误操作而导致设备损坏。

同时,二手信息是存在很多个人偏好的。总结的人会从自己的思路出发来写,因此整理出来的重点也不一定是和你的疑问点最匹配的。包括我自己这每周写的 newsletter,显然充斥着我个人的风格,比如上一篇2023 年度 AI 发展报告,如果你去读原文链接,可能收获的远不止读我写的。而文档则不同,我们通常阅读的,不管是说明书还是一些官方文档,里面的文字都是别人一整个团队逐字逐句斟酌出来的,如何能让用户最好的吸收,他们已经尽了最大努力。更不用说一本好书了,通常都是作者呕心沥血写出来,然后再经过很多道工序才能出版的。

另外,读文档不一定是要逐字逐句,最重要的是目录。我很久很久之前也写过建立索引是最重要的,有了框架才能查漏补缺。就像 401k 中涉及到了税务、公司福利、基金构成等,只有把各个系统都理解了,才能穿插着把它们串联起来,从而找出最佳的配置方案。

最后,我想说有时候笨办法才是最聪明的,慢慢来才是最快的。读文档不一定能直接给我们生活的最优解,但是他能让我们趋近于知道最优解的路径。生活就像一场冒险,也许文档就是我们手中的地图和指南针。

Subscribe to GeekPlux Letters

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.
jamie@example.com
Subscribe