修補接受程序

回報問題 查看來源

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

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

    這會觸發內部預先審查檢查,並提出新的變更建議。如果您尚未提供偏好設定,提交變更的維護者會新增「一般」變更 (例如程式碼檢查),而這不會影響設計。如果您需要進行進一步變更,或您想直接套用變更,則審查人員應在評論留言中清楚告知偏好設定。

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