共用方式為


在瀏覽器中編輯 Microsoft Learn 檔

提示

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

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

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

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

必要條件

在瀏覽器中編輯檔

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

    Azure 檔文章的螢幕快照,其中顯示 **Edit** 鉛筆圖示。

    如果 [編輯鉛筆] 圖示不存在,表示內容不會公開給公眾參與。 會產生某些頁面(例如,從程式代碼中的內嵌檔),而且必須在所屬專案中編輯。

  2. 選取 GitHub 檔案頁面頂端的 [ 編輯 鉛筆] 圖示。 如果 [編輯鉛筆] 圖示無法使用(顯示為暗灰色),或未顯示,您必須登入您的 GitHub 帳戶。

    GitHub 內 Azure 文章的螢幕快照,其中顯示 **Edit** 鉛筆圖示。

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

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

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

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

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

    建議變更彈出視窗的螢幕快照。

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

    比較變更畫面的螢幕快照。

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

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

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

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

限制

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