Bazel menghosting Grup Minat Khusus (SIG) untuk memfokuskan kolaborasi di area tertentu dan mendukung komunikasi serta koordinasi antara pemilik, pengelola, dan kontributor Bazel. Kebijakan ini berlaku untuk bazelbuild.
SIG melakukan pekerjaan mereka secara publik. Cakupan yang ideal untuk SIG mencakup domain yang terdefinisi dengan baik, dengan sebagian besar partisipasi 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 Eksekusi Jarak Jauh).
Meskipun tidak semua SIG akan memiliki tingkat energi, cakupan, atau model tata kelola yang sama, harus ada bukti yang cukup bahwa ada anggota komunitas yang bersedia berpartisipasi dan berkontribusi jika grup minat tersebut dibentuk. Sebelum bergabung, tinjau pekerjaan grup, lalu hubungi pemimpin SIG. Kebijakan keanggotaan bervariasi berdasarkan SIG.
Lihat daftar lengkap SIG Bazel.
Non-sasaran: Apa yang bukan merupakan SIG
SIG dimaksudkan untuk memfasilitasi kolaborasi dalam pekerjaan bersama. Oleh karena itu, SIG adalah:
- Bukan forum dukungan: milis dan SIG bukanlah hal yang sama
- Tidak langsung diperlukan: di awal siklus proses proyek, Anda mungkin tidak tahu apakah Anda telah membagikan pekerjaan atau kolaborator
- Bukan tenaga kerja gratis: energi diperlukan untuk mengembangkan dan mengoordinasikan pekerjaan secara kolaboratif
Pemilik Bazel mengambil pendekatan konservatif terhadap pembuatan SIG—berkat kemudahan memulai project di GitHub, ada banyak cara untuk berkolaborasi tanpa memerlukan SIG.
Siklus proses SIG
Bagian ini membahas cara membuat SIG.
Riset dan konsultasi
Untuk mengusulkan grup SIG baru, kumpulkan terlebih dahulu bukti untuk mendapatkan persetujuan, seperti yang ditentukan di bawah. Beberapa kemungkinan cara yang dapat dipertimbangkan adalah:
- Masalah atau serangkaian masalah yang terdefinisi dengan baik yang akan diselesaikan oleh grup
- Konsultasi dengan anggota komunitas yang akan mendapatkan manfaat, dengan menilai manfaat dan kesediaan mereka untuk berkomitmen
- Untuk project yang sudah ada, bukti dari masalah dan PR yang menunjukkan bahwa kontributor peduli dengan topik tersebut
- Potensi tujuan yang ingin dicapai grup
- Persyaratan resource untuk menjalankan grup
Meskipun kebutuhan akan SIG tampak jelas, riset dan konsultasi tetap penting untuk kesuksesan grup.
Buat grup baru
Grup baru harus mengikuti proses di bawah ini untuk mendapatkan piagam. Secara khusus, harus menunjukkan:
- Tujuan dan manfaat yang jelas untuk Bazel (baik terkait sub-proyek atau area aplikasi)
- Dua kontributor atau lebih yang bersedia bertindak sebagai pemimpin grup, keberadaan kontributor lain, dan bukti permintaan untuk grup
- Setiap grup harus menggunakan minimal satu milis yang dapat diakses secara publik. SIG dapat menggunakan kembali salah satu daftar publik, seperti bazel-discuss, meminta daftar untuk @bazel.build, atau membuat daftar mereka sendiri
- Resource yang awalnya diperlukan SIG (biasanya, milis dan panggilan video reguler).
- SIG dapat menyajikan dokumen dan file dari direktori mereka di
bazelbuild/communityatau dari repositori mereka sendiri di organisasibazelbuildGitHub. SIG dapat menautkan ke resource eksternal jika memilih untuk mengatur pekerjaan mereka di luar organisasi GitHubbazelbuild - Pemilik Bazel menyetujui atau menolak aplikasi SIG dan berkonsultasi dengan pemangku kepentingan lain jika diperlukan
Sebelum memasuki bagian formal dari proses, Anda harus berkonsultasi dengan tim produk Bazel di product@bazel.build. Sebagian besar SIG memerlukan percakapan dan iterasi sebelum persetujuan.
Permintaan resmi untuk grup baru dilakukan dengan mengirimkan piagam sebagai PR ke
bazelbuild/community,
dan menyertakan permintaan dalam komentar pada PR yang mengikuti template
di bawah. Setelah disetujui, PR untuk grup akan digabungkan dan resource yang diperlukan akan dibuat.
Template Permintaan SIG Baru
Untuk meminta SIG baru, gunakan template di repositori komunitas: SIG-request-template.md.
Penyewaan
Untuk membentuk grup, Anda memerlukan piagam dan harus mematuhi kode etik Bazel. Arsip grup akan bersifat publik. Keanggotaan dapat terbuka untuk semua orang tanpa persetujuan, atau tersedia berdasarkan permintaan, menunggu persetujuan administrator grup.
Piagam harus menunjuk seorang administrator. Selain administrator, grup harus menyertakan setidaknya satu orang sebagai ketua (orang ini bisa sama dengan administrator), yang bertindak sebagai narahubung untuk koordinasi sebagaimana diperlukan dengan tim produk Bazel.
Pembuat grup harus memposting piagam mereka ke milis grup. Repositori komunitas di organisasi GitHub Bazel mengarsipkan dokumen dan kebijakan tersebut. Seiring berkembangnya praktik dan konvensi grup, mereka harus memperbarui piagamnya di bagian yang relevan dalam repositori komunitas.
Kolaborasi dan inklusi
Meskipun tidak diwajibkan, grup harus memilih untuk memanfaatkan kolaborasi melalui panggilan konferensi terjadwal atau channel chat untuk mengadakan rapat. Setiap pertemuan semacam itu harus diiklankan di milis, dan catatan harus diposting ke milis setelahnya. Rapat rutin membantu mendorong akuntabilitas dan progres dalam SIG.
Anggota tim produk Bazel dapat secara proaktif memantau dan mendorong grup untuk berdiskusi dan mengambil tindakan yang sesuai.
Meluncurkan SIG
Aktivitas yang diperlukan:
- Memberi tahu grup diskusi umum Bazel (bazel-discuss, bazel-dev).
Aktivitas opsional:
- Buat postingan blog untuk blog Bazel
Kesehatan dan penghentian SIG
Pemilik Bazel berupaya sebaik mungkin untuk memastikan kesehatan SIG. Pemilik Bazel terkadang meminta ketua SIG untuk melaporkan pekerjaan SIG, untuk memberi tahu komunitas Bazel yang lebih luas tentang aktivitas grup.
Jika SIG tidak lagi memiliki tujuan yang berguna atau komunitas yang tertarik, SIG tersebut dapat diarsipkan dan berhenti beroperasi. Tim produk Bazel berhak mengarsipkan SIG yang tidak aktif tersebut untuk menjaga kesehatan keseluruhan project, meskipun hal ini kurang disukai. SIG juga dapat memilih untuk membubarkan diri jika SIG tersebut menyadari bahwa SIG tersebut telah mencapai akhir masa pakainya.
Catatan
Konten ini telah diadaptasi dari buku pedoman SIG Tensorflow dengan modifikasi.