本頁面將概述貢獻者如何提出及變更 Bazel 程式碼集。
- 詳閱 Bazel 貢獻政策。
- 建立 GitHub 問題,討論您的計畫和設計。變更或新增行為的提取要求需要對應的問題進行追蹤。
- 如果您要做出重大變更,請撰寫設計文件,
- 請確認您已簽署貢獻者授權協議。
- 準備實作功能的 Git 修訂版本。別忘了新增測試並更新說明文件如果變更會對使用者造成可見的影響,請新增版本附註。如果是相容性變更,請參閱推出破壞性變更的指南。
- 在 GitHub 上建立提取要求。如果您是 GitHub 新手,請參閱關於提取要求。請注意,我們會限制在主要 Bazel 存放區建立分支的權限,因此您必須將提交內容推送至您自己的存放區分支。
- Bazel 維護人員應在兩個工作天內 (不含美國和德國的假日) 指派審查人員。如果您在該時間內沒有指派審查者,可以傳送電子郵件至 bazel-discuss@googlegroups.com 來要求審查。
- 請與審查者合作完成程式碼審查。針對每項變更,請建立新的修訂版本並推送,以便對提取要求進行變更。如果審查時間過長 (例如審查人員未回應),請傳送電子郵件至 bazel-discuss@googlegroups.com。
檢查完畢後,Bazel 維護工具會將您的修補程式套用至 Google 的內部版本管控系統。
這會觸發內部提交前檢查,可能會建議您進行更多變更。如果您未明確表示偏好設定,提交變更的維護人員會新增不會影響設計的「瑣碎」變更 (例如linting)。如果需要進行更深入的變更,或您想要直接套用變更,您和審查人員應在審查註解中明確說明偏好設定。
在內部提交後,系統會將修補程式匯出為 Git 提交內容,並關閉 GitHub 提取要求。所有最終變更都會歸功於您。