
一、前言
說起微軟官方文檔,使用微軟系相關語言開發者絕對不會陌生,要說評價,褒貶不一
,好壞各參半
,無腦機翻
和真香定理
,對於初學者來說,上來就看官方文檔,時常容易在一篇官方文檔里,迷路,找不到出口,其實微軟文檔中,包含很多細碎的知識和體系化的知識體系結構,直到現在,筆者還在文檔里發現不同的新知識,那要問了,如何在文檔中進行檢索?請聽筆者細細道來。
二、站內站外
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/