Halaman ini menguraikan cara kontributor dapat menyarankan dan melakukan perubahan pada basis kode Bazel.
- Baca kebijakan Kontribusi Bazel.
- Buat masalah GitHub untuk membahas rencana dan desain Anda. Permintaan pull yang mengubah atau menambahkan perilaku memerlukan masalah yang sesuai untuk pelacakan.
- Jika Anda mengusulkan perubahan signifikan, tulis dokumen desain.
- Pastikan Anda telah menandatangani Perjanjian Lisensi Kontributor.
- Siapkan commit git yang mengimplementasikan fitur. Jangan lupa menambahkan pengujian dan memperbarui dokumentasi. Jika perubahan Anda memiliki efek yang terlihat oleh pengguna, tambahkan catatan rilis. Jika perubahan tidak kompatibel, baca panduan untuk meluncurkan perubahan yang menyebabkan gangguan.
- Buat permintaan pull di GitHub. Jika Anda baru menggunakan GitHub, baca tentang permintaan pull. Perhatikan bahwa kami membatasi izin untuk membuat cabang di repositori Bazel utama, jadi Anda harus mengirimkan commit ke fork repositori Anda sendiri.
- Pengelola Bazel akan menugaskan peninjau kepada Anda dalam waktu dua hari kerja (tidak termasuk hari libur di Amerika Serikat dan Jerman). Jika Anda tidak ditetapkan sebagai peninjau dalam jangka waktu tersebut, Anda dapat memintanya dengan mengirim email ke bazel-discuss@googlegroups.com.
- Bekerja sama dengan peninjau untuk menyelesaikan peninjauan kode. Untuk setiap perubahan, buat commit baru dan kirimkan untuk membuat perubahan pada permintaan pull Anda. Jika peninjauan memakan waktu terlalu lama (misalnya, jika peninjau tidak merespons), kirim email ke bazel-discuss@googlegroups.com.
Setelah peninjauan Anda selesai, pengelola Bazel akan menerapkan patch Anda ke sistem kontrol versi internal Google.
Tindakan ini memicu pemeriksaan pra-commit internal yang dapat menyarankan lebih banyak perubahan. Jika Anda belum menyatakan preferensi, pemelihara yang mengirimkan perubahan Anda akan menambahkan perubahan "sepele" (seperti linting) yang tidak memengaruhi desain. Jika perubahan yang lebih mendalam diperlukan atau Anda lebih suka menerapkan perubahan secara langsung, Anda dan peninjau harus mengomunikasikan preferensi dengan jelas dalam komentar peninjauan.
Setelah pengiriman internal, patch diekspor sebagai commit Git, dan pada saat itu permintaan pull GitHub ditutup. Semua perubahan akhir dikaitkan dengan Anda.