我再说一遍-微软官方文档查询技巧分享


blog-Microsoft-Header

一、前言

说起微软官方文档,使用微软系相关语言开发者绝对不会陌生,要说评价,褒贬不一好坏各参半无脑机翻真香定理,对于初学者来说,上来就看官方文档,时常容易在一篇官方文档里,迷路,找不到出口,其实微软文档中,包含很多细碎的知识和体系化的知识体系结构,直到现在,笔者还在文档里发现不同的新知识,那要问了,如何在文档中进行检索?请听笔者细细道来。

二、站内站外

2.1、搜索引擎

对于在微软官方站点外,搜索引擎的选择也会有一定的影响,对于用户是开发者来说,使用 BingGoogle 查询到的专业术语的结果相对于 Baidu 广告少点。笔者推荐使用 Bing 好歹国内不会访问不到。

blog-jq-browser01

2.2、检索关键词(匹配命中)

a、学会问题内容拆分,简短词检索

在遇到问题的过程中,需要注意几步,有了搜索引擎,并不代表自己,就可以高枕无忧,无脑检索,就能够获取到对应需要的信息,还需要在检索时,首先对自己需要检索的信息进行初步关键词筛选,搜索引擎毕竟不是万能药,也是依据用户输入内容进行联想词输出和关键词检索,越是精确的泛类词汇,匹配和检索到的结果符合要求的可能性就越高。类似“为什么..”,“如何..”,“怎样..” 并不会提高想要检索到的结果,更多的是给引擎在进行字词拆分时,带来无用数据结果匹配。笔者的办法是 简短关键词,一般就一个词语<空格>另一个词语,同时,微软文档中,关键点内容,经常是 小关键词|微软文档

例如:C#|微软文档,搜索结果如下:

blog-jq-engineresult

查看socket类,socket|微软文档 检索结果如下:

blog-jq-socketresult

b、自我询问

遇到不会的问题,可以在梳理好自己的问题和实际需求后,寻求广大互联网群友,在自己不知道自己需求关键词但是需求很明确时,不妨借助外部力量去简化和缩小问题检索的关键词范围,获取到关键词后,再次进行上述,方法a 的关键词查找,比起记忆自己一看就头晕的大片大片问题描述内容,关键词的学习和记忆,从数量上轻松很多,可以在不断学习关键词的同时,树立起个人知识体系概念。

2.3、站内目录

现有微软官方中文站点链接如下:

https://docs.microsoft.com/zh-cn/

红框部分即为对应的标准文档入口,内容如下:

blog-jq-microsofthome

下方的产品目录也是对应的一些快速技术入口:
blog-jq-kuaisurukou

文档入口链接如下:

https://docs.microsoft.com/zh-cn/documentation/

技术文档首页搜索部分:

blog-jq-document

产品目录(全部),对于 .NET 开发者来说,直接选择第一个产品即可,如下图:

blog-jq-produceall

请求地址如下:

https://docs.microsoft.com/zh-cn/dotnet/

顶部菜单为对应入口之一:

blog-jq-documentnav

简单卡片引导:
blog-jq-documentcard

最新.NET引导入口:

blog-jq-core

应用程序各类平台框架分布:

blog-jq-content

各类语言库,官方框架程序集入口:

blog-jq-framework

不要看上述页面中,大量的链接引导,其实,真实的内容很多都是一样的只是对外看着内容比较丰富,总共分为,入门应用,高级场景,以及新手学习,再一个是微软各类平台的平台应用入口,排除吃饭系列外。

进入下层就进入对应的官方主要文档内容区域,主要分为左右结构,此处以 Web- Asp.net Core 为例,具体如下:

blog-jq-micontent

左列主目录:

包含当前,主要教程中的细细内容,涉及到应用教程入门字样,多是讲解的 初学相关技术 的开发人员,进行基础案例上手操作, 涉及到例如 相关简短概括的技术知识,多为专题学习的主题技术细节内容,能够让开发者,更加深入的了解对应使用技术的技术实现细节,比较偏向于 ,不遇到问题,不看类型,日常翻翻目录进行。

内容目录:

点击对应主目录下的对应教程链接,大多非概述链接,都带有当前文章的菜单引导,读取具体内容前,可先查看内容目录,便于考虑是否需要进行完整阅读还是选择性阅读。

blog-jq-blogtree

避免刨根问底:

有人就会说了,讲这么多,你就给我看这个,干货呢?

实际上讲解这些的目的是为了,让读者有一个清晰的认识,文档结构并没有,想的那么乱,基本上在不断使用过程中,能够摸出一套实用规律,目录是最好的引导,每篇文章中存在着大量的可以访问的跳转链接,在浏览的过程中,尽量避免,无脑来回切换各个层级的访问站点,很容易迷路,最后看的云里雾里,建议,依据实际的主目录和内容目录进行选择性的查看,先初略浏览一遍内容,发现大内容中,有无当前问题需要的资料,如果没有就接着找其他的。刨根问底并不是不提倡,而是需要读者在阅读微软文档时,学会轻重取舍,能够关注主要的问题解决方向,当然,也可以没事儿的多翻翻,毕竟,微软构建器的这么庞大的一套知识体系库,多看看翻一翻就当涨涨见识。

三、关键词积累

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/

原文地址:https://www.cnblogs.com/guanguanchangyu/p/15328234.html