在瀏覽器中編輯 Microsoft Learn 檔

提示

本主題提供自我步調的 逐步學習路徑 。

Microsoft 的數個檔集 開放原始碼 並裝載在 GitHub 上。 雖然並非所有檔集都完全 開放原始碼，但許多人都有公開的存放庫，您可以在其中透過提取要求 （PR） 來建議變更。 此開放原始碼方法會簡化和改善產品工程師、內容小組和客戶之間的通訊。

快速編輯有助於報告並修正檔中的小錯誤和遺漏的程式。 即便我們非常努力，發佈的文件中仍不免存在少許文法和拼字錯誤。 感謝您協助找出並修正這些問題！

我們針對所有變更使用PR，即使是具有寫入存取權的參與者也是如此。 大部分的存放庫都會保護預設分支，因此必須將更新提交為 PR。

必要條件

• 如果您沒有 GitHub 帳戶，請建立一個帳戶。

在瀏覽器中編輯檔

1. 瀏覽至您想要編輯的檔案。 某些文件頁面允許您直接在瀏覽器中編輯內容。 若是如此，您會看到 [編輯 鉛筆] 圖示，如下所示。 選擇 [ 編輯 鉛筆] 圖示會帶您前往 GitHub 上的原始程序檔。

   

   如果 [編輯] 按鈕不存在，表示內容不會開放給公用貢獻。 會產生某些頁面（例如，從程式代碼中的內嵌檔），而且必須在所屬專案中編輯。

2. 選取 GitHub 檔案頁面頂端的鉛筆圖示。 如果鉛筆圖示呈現灰色或未顯示，您必須登入您的 GitHub 帳戶。

   

   文章頂端是發行項的元數據。 中繼資料會套用至發行項以進行報告、透過搜尋獲得發現性，及推動網站體驗的各個層面。 如果您要對已發佈的文章進行次要更新，您可能不需要變更元數據。

3. 如果您是第一次在此存放庫中工作，系統會提示您在提出變更之前派生存放庫。 選取 [分支此存放庫 ] 以繼續。

4. 在網頁編輯器中編輯檔案。 選擇工具列中的 [ 預覽] 索引標籤，以檢查變更的格式設定。

5. 當您完成編輯時，請選取 [認可變更] 或 [建議變更] 按鈕，通常是在畫面右上角。

6. 輸入認可訊息。 認可訊息會成為PR的標題，而且應該是變更的簡短摘要（例如，修正拼字和文法錯誤）。 選擇性地新增 擴充描述 ，以提供有關變更的詳細數據。 選取 [建議變更]：

   

7. 既然您已提出並認可變更，您必須要求存放庫的擁有者將變更「提取」到其存放庫中。 這是使用 提取要求（PR） 來完成的。 當您選取 [ 建議變更] 時，您會看到如下的頁面：

   

   您的 PR 會建議從分支和分支（由箭號右側的兩個專案代表）變更至檔存放庫的主要分支和 main 分支（由箭號左邊的兩個專案表示）。

   檢閱您的變更，然後選取 [ 建立提取要求]。

8. 在 [ 開啟提取要求 ] 頁面上，預覽您的 PR。 如有需要，您可以變更標題或描述欄位。 當您準備好時，請選取 [ 建立提取要求]。 此動作會開啟您的 PR，並警示您已提出變更的文章擁有者。

9. 介紹完畢 內容小組成員會檢閱您的PR，並在核准時加以合併。 您可能會收到要求變更的意見反應。 如需處理PR的詳細資訊，請參閱 處理提取要求。

限制

• 大部分本地化的內容（亦即翻譯的）內容都無法透過 GitHub 進行編輯。 不過，您可以選取頁面頂端的 [意見反應] 按鈕，然後選擇 翻譯品質原因，提供翻譯品質 的意見反應。 您也可以使用 [提供意見 反應] 窗體，對本地化內容留下更具體的意見反應。
• 瀏覽器內編輯體驗最適合次要和不常變更。 如果您做出大量貢獻或使用進階 Git 功能（例如分支管理或進階合併衝突解決），建議您 分叉存放庫並在本機工作。