Bazel menghosting Grup Minat Khusus (SIG) untuk memfokuskan kolaborasi pada area
tertentu dan untuk mendukung komunikasi serta koordinasi antara pemilik,
pengelola, dan kontributor Bazel. Kebijakan ini
berlaku untuk bazelbuild
.
SIG melakukan tugasnya di depan umum. Cakupan ideal untuk SIG mencakup domain yang ditentukan dengan baik, yang sebagian besar partisipasinya berasal dari komunitas. SIG dapat berfokus pada repositori yang dikelola komunitas di bazelbuild
(seperti aturan bahasa) atau berfokus pada area kode di repositori Bazel (seperti Remote Execution).
Meskipun tidak semua SIG akan memiliki tingkat energi, cakupan lingkup, atau model tata kelola yang sama, harus ada bukti yang memadai bahwa ada anggota komunitas yang bersedia untuk berinteraksi dan berkontribusi jika grup minat tersebut dibentuk Domain. Sebelum bergabung, tinjau pekerjaan grup, lalu hubungi pemimpin SIG. Kebijakan keanggotaan bervariasi berdasarkan SIG.
Lihat daftar lengkap Bazel SIG.
Bukan sasaran: Apa yang bukan SIG
SIG dimaksudkan untuk memfasilitasi kolaborasi pada pekerjaan bersama. Oleh karena itu, SIG:
- Bukan forum dukungan: milis dan SIG bukanlah hal yang sama
- Tidak langsung dibutuhkan: di masa awal project, Anda mungkin tidak tahu apakah Anda telah berbagi tugas atau kolaborator
- Bukan tenaga kerja bebas: energi diperlukan untuk menumbuhkan dan mengoordinasikan pekerjaan secara kolaboratif
Pemilik Bazel mengambil pendekatan konservatif untuk pembuatan SIG—berkat kemudahan project di GitHub, ada banyak jalan di mana kolaborasi dapat terjadi tanpa memerlukan SIG.
Siklus proses SIG
Bagian ini membahas cara membuat SIG.
Penelitian dan konsultasi
Untuk mengusulkan grup SIG baru, kumpulkan bukti terlebih dahulu untuk mendapatkan persetujuan, seperti yang ditentukan di bawah ini. Beberapa cara yang dapat dipertimbangkan adalah:
- Masalah yang didefinisikan dengan baik atau serangkaian masalah yang akan diselesaikan grup
- Konsultasi dengan anggota komunitas yang akan mendapatkan manfaat, menilai manfaat dan kesediaan mereka untuk berkomitmen
- Untuk project yang sudah ada, bukti dari masalah dan PR yang ditujukan kontributor untuk topik tersebut
- Kemungkinan sasaran untuk dicapai grup
- Persyaratan resource untuk menjalankan grup
Meskipun kebutuhan akan SIG terlihat jelas, riset dan konsultasi masih penting untuk keberhasilan kelompok.
Buat grup baru
Grup yang baru harus mengikuti proses charter di bawah ini. Secara khusus, contoh ini harus menunjukkan:
- Tujuan dan manfaat yang jelas untuk Bazel (di sekitar area sub-project atau aplikasi)
- Dua atau lebih kontributor bersedia untuk bertindak sebagai pimpinan kelompok, keberadaan kontributor lain, dan bukti permintaan kelompok
- Setiap grup perlu menggunakan setidaknya satu milis yang dapat diakses secara publik. SIG dapat menggunakan kembali salah satu daftar publik, seperti bazel-diskusi, meminta daftar untuk @bazel.build, atau membuat daftar sendiri.
- Referensi yang awalnya diperlukan SIG (biasanya milis dan panggilan video reguler).
- SIG dapat menayangkan dokumen dan file dari direktorinya di
bazelbuild/community
atau dari repositorinya sendiri dalambazelbuild
GitHub. SIG dapat menautkan ke resource eksternal jika mereka memilih untuk mengelola tugasnya di luar organisasi GitHubbazelbuild
- Pemilik Bazel menyetujui atau menolak permohonan SIG dan berkonsultasi dengan pemangku kepentingan lainnya sebagaimana diperlukan
Sebelum masuk ke bagian formal dari proses ini, Anda harus berkonsultasi dengan tim produk Bazel, di product@bazel.build. Sebagian besar SIG memerlukan percakapan dan iterasi sebelum disetujui.
Permintaan formal untuk grup baru dilakukan dengan mengirimkan piagam sebagai PR kebazelbuild/community
,
dan menyertakan permintaan dalam komentar pada permintaan pull mengikuti template
di bawah ini. Setelah disetujui, permintaan pull untuk grup tersebut akan digabungkan dan resource yang diperlukan akan dibuat.
Permintaan Template untuk SIG Baru
Untuk meminta SIG baru, gunakan template di repo komunitas: SIG-request-template.md.
Penyewaan Kapal
Untuk membuat grup, Anda memerlukan charter dan harus mengikuti kode etik Bazel. Arsip grup akan bersifat publik. Keanggotaan dapat terbuka untuk semua tanpa persetujuan, atau tersedia berdasarkan permintaan, menunggu persetujuan administrator grup.
Piagam harus menominasikan administrator. Selain administrator, grup harus menyertakan setidaknya satu orang sebagai prospek (ini mungkin orang yang sama), yang berfungsi sebagai kontak untuk koordinasi seperti yang diperlukan dengan tim produk Bazel.
Pembuat grup harus memposting charter mereka ke milis grup. Repositori komunitas di organisasi GitHub Bazel mengarsipkan dokumen dan kebijakan tersebut. Saat grup mengembangkan praktik dan konvensi, mereka harus memperbarui charter dalam bagian repositori komunitas yang relevan.
Kolaborasi dan inklusi
Meskipun tidak dimandatkan, grup harus memilih untuk menggunakan kolaborasi melalui panggilan konferensi terjadwal atau saluran chat untuk melakukan rapat. Setiap rapat seharusnya diiklankan di milis dan catatan diposting ke milis setelahnya. Rapat rutin membantu mendorong akuntabilitas dan kemajuan dalam SIG.
Anggota tim produk Bazel mungkin secara proaktif memantau dan mendorong grup untuk berdiskusi dan mengambil tindakan yang sesuai.
Meluncurkan SIG
Aktivitas yang diperlukan:
- Beri tahu grup diskusi umum Bazel (bazel-Discuss, bazel-dev).
Aktivitas opsional:
- Membuat postingan blog untuk blog Bazel
Kesehatan dan penghentian SIG
Pemilik Bazel melakukan upaya terbaik untuk memastikan kesehatan SIG. Pemilik Bazel sesekali meminta prospek SIG untuk melaporkan pekerjaan SIG, guna menginformasikan aktivitas grup tersebut kepada komunitas Bazel yang lebih luas.
Jika SIG tidak lagi memiliki tujuan atau komunitas yang diminati, SIG mungkin diarsipkan dan berhenti beroperasi. Tim produk Bazel berhak mengarsipkan SIG tidak aktif tersebut untuk mempertahankan kondisi project secara keseluruhan, meskipun itu adalah hasil yang kurang lebih baik. SIG juga dapat membubarkan jika mengetahui telah mencapai akhir masa berlakunya.
Catatan
Konten ini telah diadopsi dari playbook SIG Tensorflow dengan modifikasi.