Share via


Microsoft Learn 上的編輯檔概觀

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

必要條件

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

對檔的次要變更

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

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

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

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

檔的重大變更

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

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

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

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

程序概觀

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

流程圖顯示開始使用參與程式的基本工作流程。

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

訓練模組的變更

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