雖然平常很少去看 Microsoft Docs 說明文件,但得知微軟將網站內部的程式碼範例集合起來還是相當興奮,畢竟這些程式碼可能四散在不同服務上,對開發者來說,範例通常有助於學習一項新技術,就像按圖索驥可以從現有的程式碼來拼湊出雛形,而開發者選擇使用 Microsoft 產品或服務時就能透過說明中心的程式碼範例輕鬆入門。

當前 Microsoft Docs 收錄超過兩千個程式碼範例,使用者可依照產品或程式語言類型篩選,或是輸入關鍵字進行即時搜尋,當然更重要的是這些程式碼範例同時被放上 GitHub,看來微軟去年在收購 GitHub 後也計畫將它整合到現有網站,開發者也能在程式庫對程式碼做出貢獻,例如解決出現的問題或改善現有程式碼,讓微軟相關團隊可以進行研究,改善程式碼品質。

除此之外,在 Microsoft Docs 提供的程式碼範例除了線上瀏覽,亦可打包為 .zip 下載,對於內建 Azure Resource Manager 範本的程式碼還能夠快速部屬到 Azure。

Microsoft Docs 程式碼範例
https://docs.microsoft.com/zh-tw/samples/browse/

使用教學

STEP 1

開啟 Microsoft Docs 程式碼範例網頁開始瀏覽內容,當前收錄超過兩千筆結果。

如果不喜歡預設的配色風格,右上角「佈景主題」調整淺色、深色或高對比顏色。

STEP 2

程式碼範例網頁相當易於搜尋瀏覽,從左側篩選功能選擇要查詢的特定產品或程式語言,選擇後會立即更新搜尋結果,或是輸入關鍵字搜尋,每個項目都有清楚易懂的主題說明和更新日期,下方也會加上標籤。

STEP 3

進入主題後,最上方的「Browse Code」連結到 GitHub 頁面,「Download ZIP」可以將範例程式碼打包下載,這些程式碼範例都會有說明,例如這段代碼的用途、架構、部屬方式和相關資源鏈結。

現在微軟提供的程式碼在 GitHub 也都能夠找到,方便使用者複製程式碼、參與專案、提交程式碼或討論等等。

STEP 4

有些包括 Azure Resource Manager(ARM)範本的頁面上方會顯示另一個按鈕,點選 Deploy to Azure 就能快速部屬到 Microsoft Azure 雲端服務。

值得一試的三個理由:

  1. 微軟將網站內部的程式碼範例集合在 Microsoft Docs 更易於搜尋使用
  2. 這些程式碼都能連結到 GitHub 頁面,也能打包為 .zip 一次下載
  3. 程式碼範例對於研究新的技術或程式語言來說也很有用