接受修補程式的程序

本頁將概略說明貢獻者如何提議及變更 Bazel 程式碼集。

1. 閱讀 Bazel 貢獻政策。
2. 建立 GitHub 問題來討論您的計畫和設計。變更或新增行為的提取要求需要相應的追蹤問題。
3. 如要提出重大變更，請編寫設計文件。
4. 確認您已簽署貢獻者授權協議。
5. 準備實作該功能的 Git 修訂版本。別忘了新增測試並更新說明文件。如果變更會向使用者顯示，新增版本資訊。如果是不相容的變更，請參閱展開破壞性變更指南。
6. 在 GitHub 上建立提取要求。如果您是 GitHub 新手，請參閱關於提取要求一文。請注意，我們會限制在主要 Bazel 存放區中建立分支的權限，因此您必須將修訂版本推送至自己的存放區分支。
7. Bazel 維護人員應在兩個工作天內 (將美國與德國的假日除外) 指派給審查者。如果您沒有在這段期間指派審查者，請傳送電子郵件至 [e-mail] 來要求審查。
8. 請與審查人員合作，完成程式碼審查。針對每個變更，建立新的修訂版本並推送變更以變更提取要求。如果審查時間過長 (例如審查者沒有回應)，請傳送電子郵件至 [e-mail]。

9. 完成審查後，Bazel 維護人員會將修補程式套用至 Google 的內部版本管控系統。

   這會觸發內部提交檢查，可能會建議更多變更。如果您尚未表示偏好設定，則提交變更的維護者會新增「設計」的變更內容 (例如 Lint)，不會影響設計。如果您必須進行更深入的調整，或決定直接套用變更，您和審查人員應在審查註解中明確傳達偏好設定。

   內部提交後，修補程式會匯出為 Git 修訂版本，屆時 GitHub 提取要求關閉。所有最終變更都會歸因於你。