我再说一遍-微软官方文档查询技巧分享
一、前言
说起微软官方文档,使用微软系相关语言开发者绝对不会陌生,要说评价,褒贬不一
,好坏各参半
,无脑机翻
和真香定理
,对于初学者来说,上来就看官方文档,时常容易在一篇官方文档里,迷路,找不到出口,其实微软文档中,包含很多细碎的知识和体系化的知识体系结构,直到现在,笔者还在文档里发现不同的新知识,那要问了,如何在文档中进行检索?请听笔者细细道来。
二、站内站外
2.1、搜索引擎
对于在微软官方站点外,搜索引擎的选择也会有一定的影响,对于用户是开发者来说,使用 Bing
和 Google
查询到的专业术语的结果相对于 Baidu
广告少点。笔者推荐使用 Bing
好歹国内不会访问不到。
2.2、检索关键词(匹配命中)
a、学会问题内容拆分,简短词检索
在遇到问题的过程中,需要注意几步,有了搜索引擎,并不代表自己,就可以高枕无忧,无脑检索,就能够获取到对应需要的信息,还需要在检索时,首先对自己需要检索的信息进行初步关键词筛选,搜索引擎毕竟不是万能药,也是依据用户输入内容进行联想词输出和关键词检索,越是精确的泛类词汇,匹配和检索到的结果符合要求的可能性就越高。类似“为什么..”,“如何..”,“怎样..” 并不会提高想要检索到的结果,更多的是给引擎在进行字词拆分时,带来无用数据结果匹配。笔者的办法是 简短关键词,一般就一个词语<空格>另一个词语
,同时,微软文档中,关键点内容,经常是 小关键词|微软文档
例如:C#|微软文档,搜索结果如下:
查看socket类,socket|微软文档
检索结果如下:
b、自我询问
遇到不会的问题,可以在梳理好自己的问题和实际需求后,寻求广大互联网群友,在自己不知道自己需求关键词但是需求很明确时,不妨借助外部力量去简化和缩小问题检索的关键词范围,获取到关键词后,再次进行上述,方法a
的关键词查找,比起记忆自己一看就头晕的大片大片问题描述内容,关键词的学习和记忆,从数量上轻松很多,可以在不断学习关键词的同时,树立起个人知识体系概念。
2.3、站内目录
现有微软官方中文站点链接如下:
https://docs.microsoft.com/zh-cn/
红框部分即为对应的标准文档入口,内容如下:
下方的产品目录也是对应的一些快速技术入口:
文档入口链接如下:
https://docs.microsoft.com/zh-cn/documentation/
技术文档首页搜索部分:
产品目录(全部),对于 .NET
开发者来说,直接选择第一个产品即可,如下图:
请求地址如下:
https://docs.microsoft.com/zh-cn/dotnet/
顶部菜单为对应入口之一:
简单卡片引导:
最新.NET
引导入口:
应用程序各类平台框架分布:
各类语言库,官方框架程序集入口:
不要看上述页面中,大量的链接引导,其实,真实的内容很多都是一样的只是对外看着内容比较丰富,总共分为,入门应用,高级场景,以及新手学习,再一个是微软各类平台的平台应用入口,排除吃饭系列外。
进入下层就进入对应的官方主要文档内容区域,主要分为左右结构,此处以 Web
- Asp.net Core
为例,具体如下:
左列主目录:
包含当前,主要教程中的细细内容,涉及到应用
,教程
,入门
字样,多是讲解的 初学相关技术
的开发人员,进行基础案例
上手操作, 涉及到例如 相关简短概括的技术知识,多为专题学习
的主题技术细节内容,能够让开发者,更加深入的了解对应使用技术的技术实现细节,比较偏向于 ,不遇到问题,不看类型,日常翻翻目录进行。
内容目录:
点击对应主目录下的对应教程链接,大多非概述链接,都带有当前文章的菜单引导,读取具体内容前,可先查看内容目录,便于考虑是否需要进行完整阅读还是选择性阅读。
避免刨根问底:
有人就会说了,讲这么多,你就给我看这个,干货呢?
实际上讲解这些的目的是为了,让读者有一个清晰的认识,文档结构并没有,想的那么乱,基本上在不断使用过程中,能够摸出一套实用规律,目录是最好的引导,每篇文章中存在着大量的可以访问的跳转链接,在浏览的过程中,尽量避免,无脑来回切换各个层级的访问站点,很容易迷路,最后看的云里雾里,建议,依据实际的主目录和内容目录进行选择性的查看,先初略浏览一遍内容,发现大内容中,有无当前问题需要的资料,如果没有就接着找其他的。刨根问底并不是不提倡,而是需要读者在阅读微软文档时,学会轻重取舍,能够关注主要的问题解决方向,当然,也可以没事儿的多翻翻,毕竟,微软构建器的这么庞大的一套知识体系库,多看看翻一翻就当涨涨见识。
三、关键词积累
3.1、语言专业术语
如何快速的从海量的信息中筛选出自己需要的关键信息,掌握相关的专业属于是有必要的,这些专业术语可以不知道具体的实现原理和实现细节,却能够比较真实的对个人的知识体系和个人水平认知,同行之间的信息互通交流,起到助推作用,一下是笔者分享的一下相关专业数据找到的官方资源链接:
[.NET 术语表]:
https://docs.microsoft.com/zh-cn/dotnet/standard/glossary
[.NET 基础知识]:
https://docs.microsoft.com/zh-cn/dotnet/fundamentals/
[C# 指南]:
C# 概念、C# 编程指南 部分
https://docs.microsoft.com/zh-cn/dotnet/csharp/
[语言参考]:
https://docs.microsoft.com/zh-cn/dotnet/csharp/language-reference/