Kebijakan kontribusi

terjemahan: manusia page_type: lcat

Halaman ini mencakup model tata kelola dan kebijakan kontribusi Bazel.

Model tata kelola

Project Bazel dipimpin dan dikelola oleh Google dan memiliki komunitas kontributor yang besar di luar Google. Beberapa komponen Bazel (seperti repositori aturan tertentu pada organisasi bazelbuild) dipimpin, dikelola, dan dikelola oleh anggota komunitas. Tim Google Bazel meninjau saran untuk menambahkan repositori milik komunitas (seperti aturan) ke organisasi GitHub bazelbuild.

Peran kontributor

Berikut adalah uraian peran dalam project Bazel, termasuk tanggung jawabnya:

  • Pemilik: Tim Google Bazel. Pemilik bertanggung jawab untuk:
    • Strategi, pemeliharaan, dan kepemimpinan proyek Bazel.
    • Membuat dan mengelola fungsi inti Bazel.
    • Menunjuk Pengelola dan menyetujui repositori baru.
  • Pengelola: Tim Google Bazel dan pengguna GitHub yang ditunjuk. Pengelola bertanggung jawab atas:
    • Membuat dan mengelola fungsi utama repositori mereka.
    • Meninjau dan menyetujui kontribusi pada area code base Bazel.
    • Mendukung pengguna dan kontributor dengan pengelolaan masalah, peninjauan PR, dan dokumentasi yang tepat waktu dan transparan.
    • Merilis, menguji, dan berkolaborasi dengan Pemilik Bazel.
  • Kontributor: Semua pengguna yang memberikan kontribusi kode atau dokumentasi ke project Bazel.
    • Membuat PR yang ditulis dengan baik untuk berkontribusi pada codebase dan dokumentasi Bazel.
    • Menggunakan saluran standar, seperti Masalah GitHub, untuk mengusulkan perubahan dan melaporkan masalah.

Menjadi Pengelola

Pemilik Bazel dapat menunjuk Pengelola untuk memimpin area kode yang ditetapkan dengan baik, seperti kumpulan aturan. Kontributor dengan catatan kontribusi terdahulu yang konsisten dan bertanggung jawab yang merencanakan kontribusi besar di masa mendatang dapat dianggap sebagai Pengelola yang memenuhi syarat.

Kebijakan kontribusi

Project Bazel menerima kontribusi dari kontributor eksternal. Berikut kebijakan kontribusi untuk area kode yang dikelola Google dan yang dikelola Komunitas.

  • Pemberian (hak) lisensi. Semua Pengelola dan Kontributor harus menandatangani Perjanjian Lisensi Kontributor Google.
  • Kontribusi. Pemilik dan Pengelola harus melakukan segala upaya untuk menerima kontribusi yang berharga. Semua kontribusi harus berupa:
    • Ditulis dengan baik dan diuji dengan baik
    • Didiskusikan dan disetujui oleh Pengelola area kode yang relevan. Diskusi dan persetujuan terjadi di Masalah GitHub dan di PR GitHub. Kontribusi yang lebih besar memerlukan peninjauan desain.
    • Ditambahkan ke sistem Continuous Integration Bazel jika belum ada.
    • Dapat didukung dan diselaraskan dengan arah produk Bazel
  • Peninjauan kode. Semua perubahan di semua repositori bazelbuild memerlukan peninjauan:
    • Semua PR harus disetujui oleh Pemilik atau Pengelola.
    • Hanya Pemilik dan Pengelola yang dapat menggabungkan PR.
  • Kompatibilitas. Pemilik mungkin perlu menolak atau meminta modifikasi pada PR jika kemungkinan kecil perubahan tersebut memerlukan modifikasi substansial pada sistem Google internal.
  • Dokumentasi. Jika relevan, kontribusi fitur harus menyertakan pembaruan dokumentasi.

Untuk mengetahui detail selengkapnya terkait cara berkontribusi ke Bazel, lihat panduan kontribusi kami.