共用方式為


處理提取要求

開啟提取要求 (PR) 之後,PR 會進行一組檢查和檢閱,以確保您可以合併建議的變更。 如需有關PR的詳細資訊,請參閱 Git 和 GitHub 基本概念

驗證

在PR可以合併到其目的地分支之前,可能需要通過一或多個PR驗證程式。 選取 [ 建立提取要求] 之後,GitHub 會執行為存放庫設定的驗證。 當驗證程序完成時,結果會出現在 PR 中。

驗證程序會根據建議的變更範圍和目的地存放庫的規則而有所不同。 提交 PR 之後,您可以預期會發生下列一或多個動作:

  • 合併性:先進行基準 GitHub 合併性測試,以確認分支中建議的變更是否與目的地分支衝突。 如果 PR 指出此測試失敗,您必須先協調導致合併衝突的內容,才能繼續處理。
  • 貢獻許可協定 (CLA):如果您是非 Microsoft 參與者,如果您參與公用存放庫,則第一次將 PR 提交至該存放庫時,系統可能會要求您完成簡短的 CLA。 清除 CLA 步驟之後,就會處理您的 PR。
  • 加上標籤:標籤會自動套用至您的 PR,以指出 PR 通過驗證工作流程的狀態。 例如,新的 PR 可能會自動收到「不要合併」標籤,指出 PR 尚未完成驗證、檢閱和簽核步驟。
  • 驗證和建置:自動檢查會驗證變更是否通過驗證測試。 驗證測試可能會產生警告或錯誤,要求您編輯PR中的一或多個檔案,才能合併。 驗證測試結果會在您的PR中新增為批注,以供檢閱,而且可能會以電子郵件傳送給您。
  • 預備:成功驗證和建置後,您變更的文章會自動部署到預備環境以供檢閱。 PR 註解會顯示預覽 URL。
  • 自動合併:如果 PR 通過驗證測試和特定準則,可能會自動合併。 在此情況下,您不需執行其他任何動作。

檢閱和處理意見反應

完成所有 PR 處理之後,您應該檢閱結果(例如 PR 批注、建置結果)。 判斷是否需要在註銷合併之前進行更多變更。 基於下列任何原因,您可能需要變更內容:

  • 檢閱者的PR批注。 如果PR檢閱者已檢閱您的PR,如果合併之前有未解決的問題或問題,他們可以透過批注提供意見反應。
  • 來自對等檢閱者的意見反應。
  • 因轉譯問題而進行格式化修正。
  • 驗證錯誤或警告。
  • 合併衝突。

如果您需要進行變更,您可以直接在PR中編輯內容,也可以返回 VS Code 進行變更。 當您完成時,請將變更認可到您的工作分支。 PR 會隨著變更自動更新。

每次您將認可新增至相同的工作分支時,都會自動將認可新增至 PR。 每次認可時,發佈系統會自動重新執行驗證並檢閱程式。

註銷和批註自動化

當您解決所有意見反應和驗證錯誤,而且您已準備好要合併變更時,就可以建立可讀取 #sign-off的新批註來註銷 PR。 您必須輸入 #sign-off 批註以合併變更。 即使所有檢閱和驗證檢查都通過,您仍須負責使用此批注告訴PR檢閱者和存放庫管理員您的變更已準備好合併。

當檢閱者判斷您的PR沒有問題且已註銷時,您的變更會合併至預設分支,並關閉PR。

批註自動化可讓在存放庫中沒有寫入許可權的使用者,藉由將適當的標籤指派給PR來完成寫入層級動作。 如果您在實作批註自動化的存放庫中工作,請使用 下表所列的標籤批註 來指派標籤、變更標籤或關閉 PR。 每當提出文章的變更時,Microsoft 作者也會透過電子郵件收到通知,以供檢閱和註銷。

主題標籤註解 作用
#sign-off 自動指派準備合併標籤,讓存放庫中的檢閱者知道 PR 已準備好進行檢閱/合併。

如果您 不是 列出的作者,並嘗試使用 #sign-off 批註登入公用存放庫 PR,PR 會更新為指出只有作者可以指派標籤。
#hold-off 移除準備合併標籤,以防您改變主意或犯錯。 在私人存放庫中,這會指派 do-not-merge 標籤。
#please-close 如果您決定不合併變更,則關閉 PR。
#please-open 重新開啟已關閉的 PR 或問題。

正在發佈

您的PR必須由PR檢閱者合併,才能在下一次排程的發佈執行中包含變更。 一般而言,PR 會依提交順序進行檢閱和合併。

在核准及合併您的貢獻之後,發佈程序會挑選它們。 根據管理您參與之存放庫的小組而定,發佈時間可能會有所不同,但是通常會在每個工作日至少發生一次。 文章發佈上線最多約需 45 分鐘。

發佈您的變更之後,變更會在 Microsoft Learn 上線,讓其他人開始學習!

下一步

介紹完畢 您已為 Microsoft Learn 內容做出貢獻!