Microsoft Learn 上的編輯檔概觀

感謝您有興趣編輯 Microsoft Learn 上的檔! 您的貢獻可協助我們確保我們的文件已正確撰寫、最新且準確。 此頁面的信息將協助您決定哪一種貢獻方法最適合您。

必要條件

開始之前,請確定您已登入 GitHub 帳戶。 如果您沒有 GitHub 帳戶,請流覽至 https://github.com/join 以取得快速且免費的註冊程式。

對檔的次要變更

次要變更是快速且容易的。 次要變更的範例包括:

  • 修正錯字
  • 修訂單一文章
  • 將區段新增至發行項
  • 更正錯誤
  • 更新中斷的連結

如果您要進行次要變更,您只需要 GitHub 帳戶!

若要進行次要變更,請選取文章頂端的 [ 編輯此檔 ] 鉛筆圖示。 此動作會帶您前往 GitHub 上的原始程式檔,您可以在其中進行變更。 當您完成時,系統會提示您建立提取要求(PR),以提出您的變更。 如需此程式的完整逐步解說,請參閱 瀏覽器中的編輯檔。

檔的重大變更

重大變更牽涉到更多的時間和精力。 主要變更的範例包括:

  • 需要數天才能完成的複雜變更
  • 您想要一起提交之多個文章的修訂
  • 建立新文章
  • 經常參與

如果您要進行重大變更,您需要下載並安裝一些工具,讓您的工作更容易。 遵循下列步驟以開始使用:

  1. 安裝 Git 和 Markdown 工具。
  2. 設定本機 Git 存放庫。
  3. 對文件進行變更。
  4. 建立 PR。

程序概觀

下列程式流程顯示針對次要和重大變更開始使用所涉及的高階步驟。 請注意,某些專案是一次性步驟,而其他專案則發生在每次您開始新的貢獻時。

Process flow map showing the basic workflow for getting started with the contribution process.

影像一開始是決定點,這是您第一次參與嗎? 如果是,下一個步驟是設定 GitHub 帳戶。 如果沒有,下一個步驟是另一個決策點,您的變更是否為次要? 如果是,下一個步驟是在瀏覽器中編輯。 如果沒有,後續步驟會涉及安裝撰寫工具、分支和複製存放庫、進行變更、開啟提取要求,以及檢閱並註銷提取要求。

訓練模組的變更

參與者無法編輯或建議訓練課程模組的變更。 目前,只有儲存在公用存放庫中的 Microsoft Learn 檔可供公開參與。