Bazel menghosting Grup Minat Khusus (SIG) untuk memfokuskan kolaborasi pada area
tertentu dan mendukung komunikasi serta koordinasi antara pemilik,
pengelola, dan kontributor Bazel. Kebijakan ini
berlaku untuk bazelbuild
.
SIG melakukan pekerjaan mereka di depan umum. Ruang lingkup yang ideal untuk SIG mencakup domain yang didefinisikan 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 Remote
Execution).
Meskipun tidak semua SIG akan memiliki tingkat energi, cakupan, atau model tata kelola yang sama, harus ada bukti yang memadai bahwa ada anggota komunitas yang bersedia untuk terlibat dan berkontribusi jika kelompok kepentingan dibentuk. Sebelum bergabung, tinjau tugas grup, lalu hubungi pemimpin SIG. Kebijakan langganan bervariasi menurut setiap SIG.
Lihat daftar lengkap Bazel SIG.
Non-sasaran: Yang bukan merupakan SIG
SIG dimaksudkan untuk memfasilitasi kolaborasi pada pekerjaan bersama. Oleh karena itu, SIG:
- Bukan forum dukungan: milis dan SIG bukanlah hal yang sama
- Tidak segera diperlukan: di awal pelaksanaan project, Anda mungkin tidak tahu apakah Anda memiliki pekerjaan bersama atau kolaborator
- Bukan tenaga kerja gratis: energi diperlukan untuk menumbuhkan dan mengoordinasikan pekerjaan secara kolaboratif
Bazel Owner mengambil pendekatan konservatif terhadap pembuatan SIG. Berkat kemudahan memulai project di GitHub, ada banyak cara di mana kolaborasi dapat dilakukan tanpa memerlukan SIG.
Siklus proses SIG
Bagian ini membahas cara membuat SIG.
Riset dan konsultasi
Untuk mengusulkan grup SIG baru, pertama-tama kumpulkan bukti untuk disetujui, seperti yang ditentukan di bawah ini. Beberapa cara yang dapat dipertimbangkan adalah:
- Masalah yang terdefinisi dengan baik atau serangkaian masalah yang akan dipecahkan oleh kelompok tersebut
- Konsultasi dengan anggota komunitas yang akan mendapatkan manfaat, menilai manfaat dan kesediaan mereka untuk berkomitmen
- Untuk proyek yang sudah ada, bukti dari isu dan Humas bahwa kontributor peduli dengan topik tersebut
- Sasaran yang mungkin dicapai grup
- Persyaratan resource untuk menjalankan grup
Meskipun kebutuhan akan SIG terlihat jelas, penelitian dan konsultasi masih penting untuk kesuksesan grup.
Buat grup baru
Grup baru harus mengikuti proses di bawah ini untuk piagam. Secara khusus, contoh ini harus menunjukkan:
- Tujuan dan manfaat yang jelas untuk Bazel (baik seputar area sub-project atau aplikasi)
- Dua kontributor atau lebih yang bersedia bertindak sebagai pemimpin grup, keberadaan kontributor lain, dan bukti permintaan untuk grup
- Setiap grup perlu menggunakan setidaknya 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 daftarnya sendiri
- Resource yang awalnya diperlukan SIG (biasanya, milis dan panggilan video reguler).
- SIG dapat menyalurkan dokumen dan file dari direktorinya di
bazelbuild/community
atau dari repositori mereka sendiri di organisasibazelbuild
GitHub. SIG dapat menautkan ke resource eksternal jika mereka memilih untuk mengatur pekerjaan mereka di luar organisasi GitHubbazelbuild
- Pemilik Bazel menyetujui atau menolak permohonan SIG dan berkonsultasi dengan pemangku kepentingan lainnya jika perlu
Sebelum memasuki bagian formal proses, Anda harus berkonsultasi dengan tim produk Bazel, di product@bazel.build. Sebagian besar SIG membutuhkan percakapan dan iterasi sebelum mendapat persetujuan.
Permintaan formal untuk grup baru dilakukan dengan mengirimkan piagam sebagai PR ke
bazelbuild/community
,
dan menyertakan permintaan dalam komentar di Humas dengan mengikuti template
di bawah ini. Setelah disetujui, Humas untuk grup akan digabungkan dan resource yang diperlukan
dibuat.
Permintaan Template untuk SIG Baru
Untuk meminta SIG baru, gunakan template di repositori komunitas: SIG-request-template.md.
Pencarteran
Untuk membentuk grup, Anda memerlukan piagam dan harus mengikuti kode etik Bazel. Arsip grup akan bersifat publik. Keanggotaan dapat terbuka untuk semua tanpa persetujuan, atau tersedia berdasarkan permintaan, yang menunggu persetujuan dari administrator grup.
Piagam harus menominasikan administrator. Seperti halnya administrator, grup tersebut harus menyertakan setidaknya satu orang sebagai pimpinan (bisa orang yang sama), yang berfungsi sebagai kontak (POC) untuk koordinasi sebagaimana diperlukan dengan tim produk Bazel.
Kreator grup harus memposting dokumen charternya ke milis grup. Repositori komunitas di organisasi Bazel GitHub mengarsipkan dokumen dan kebijakan tersebut. Saat grup mengembangkan praktik dan konvensi, mereka harus memperbarui charter dalam bagian yang relevan dari repositori komunitas.
Kolaborasi dan inklusi
Meskipun tidak diwajibkan, grup harus memilih untuk memanfaatkan kolaborasi melalui panggilan konferensi terjadwal atau saluran chat untuk melakukan rapat. Rapat semacam itu harus diiklankan di milis, dan catatan yang diposting ke milis setelahnya. Pertemuan rutin membantu mendorong akuntabilitas dan kemajuan 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:
- Membuat postingan blog untuk blog Bazel
Kondisi dan penghentian SIG
Pemilik Bazel melakukan upaya terbaik untuk memastikan kesehatan SIG. Pemilik Bazel terkadang meminta pimpinan SIG untuk melaporkan pekerjaan SIG, guna memberi tahu komunitas Bazel yang lebih luas tentang aktivitas grup tersebut.
Jika SIG tidak lagi memiliki tujuan yang berguna atau komunitas yang berminat, SIG dapat diarsipkan dan menghentikan operasi. Tim produk Bazel berhak mengarsipkan SIG yang tidak aktif tersebut untuk menjaga kesehatan project secara keseluruhan, meskipun hasilnya kurang baik. SIG juga dapat memilih untuk dibubarkan jika mengetahui bahwa masa manfaatnya telah tercapai.
Catatan
Konten ini telah diadopsi dari playbook SIG Tensorflow dengan beberapa modifikasi.