程序猿必备技能--看官方文档那些事|官方文档阅读技巧|为什么要看文档~（个人总结，有感而发）
date
Apr 16, 2021
slug
why-document
status
Published
tags
迷思
type
Post
summary
看官方文档那些事|官方文档阅读技巧|为什么要看文档
是什么
官方发布的文档
为什么要看
出版书籍的毕竟是需要面对更多的受众，不够细节，而有些工具，不可能是大众的。并且出版需要时间，有些最新技术的获取，比较好的来源也就是官方文档或者是社区了。因此，走官方文档+社区这条路是比较好的技术获取源泉。对我而言，现在面临新事物的时候，都是先去看看官方的Document。
好处：
- 内容是最新的，方便，省钱，基本不会出现错误
- 获取的信息密度较大（比如作者准备书和文档的时间都是一个月，但是读一章书和可能要2小时，看文档是10分钟。），因为文档经过分类，规划和润色，一些的名字有链接，可以直接跳转。
- 文档一般是非常全面的，可以帮我们形成体系化的知识。
缺点:
- 对于刚入行的新手，官方文档并不是一个很好的选择。技术是通的，只要学会一个再学习其他的就比较容易了。但是，一门都不会的直接看官方文档，可能会遇到更多需要补课的地方。也许花的时间会太长，此时不如找个老师入门，或者查看一些视频教程（虽然我并不推荐）。
- 文档大部分是英语，对英语不好的人有阅读门槛。
怎么看
来源
直接google搜想要的技术的官网document，或者搜是否有中文文档,或者去知乎等社区，找老师和身边小伙伴问一下。
比如web标准：
技巧
- 对于官方文档，一般而言都是英文，其实对于程序员而言，常用的英文也就那么多，也不是很复杂。英文不会的可以下个网易有道词典，查单词比较方便。
- 一般而言，只要使用的东西不是太小众，都是有自发的网友或者社区将其翻译成中文。可以直接搜索一下文章的标题。（注意有些网站可能自己就有中文版本，但是中文版本和英文版本的内容会有不一样的，比如有些例子在预览的时候，中文状态下可能预览不了）。
心态
- 不要对着一大堆英文就发怵，要勇敢的上！一开始读不下去的话，可以强制自己做个笔记，记下到底在讲什么，过几天你会发现，其实单词也就这么多。不用强制的去翻译也能看懂了。
- 有一个成功的经验以后，对着各种英文网站、文档或者书，就不会发怵了，因为单词就那么多，到时候就熟悉了。
目的
- 其实现在技术很多，每个技术都有不同的特点，没有人可以记清所有东西，因此阅读文档的时候主要是让自己有个框架，以后要用的时候，知道去哪里查就好了。
总结
各种学习方式有不同的优点和缺点，文档更像是一本字典或者说明书，而书或者视频是一个教程，教程是以教学为目的，而说明书更像是对自家产品做一个说明，告诉用户用什么功能，可以看什么。
如果是新手，阅读说明书是不太好的，应该先去阅读书籍，或者看视频教程对所学的东西有点了解再看文档。
一个修手机的师傅想知道怎么修洗衣机，他只需要了解洗衣机的基本构造，有哪些零部件，怎么拆就可以了，他需要的是维修说明书。这就好比一个小白想学修洗衣机，他不仅要知道洗衣机的基本构造，有哪些零部件，怎么拆？还要学习电路、电子元器件的一些知识，他需要的是教程。而一个修手机的师傅想知道怎么修洗衣机，他只需要了解洗衣机的基本构造，有哪些零部件，怎么拆就可以了，他需要的是维修说明书。
要实现从一个阅读教程学生到一位用说明书用户转变的时候，文档是必须要看的。
希望本文章起到抛砖引玉的作用，让大家认识到文档的重要性，不再害怕看文档！~