接受修補程式的程序

本頁面將概述貢獻者如何提出及變更 Bazel 程式碼集。

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

9. 檢查完畢後，Bazel 維護工具會將您的修補程式套用至 Google 的內部版本管控系統。

   這會觸發內部預先提交檢查，並可能建議其他變更。如果您尚未表示偏好，提交變更的維護人員會加入不影響設計的「重大」變更 (例如 Lint)。如需進一步變更，或者您希望直接套用變更，您和審查者應在評論留言中明確傳達偏好設定。

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