Bazel menjadi tuan rumah {i>Special interest Groups<i} (SIG) untuk memfokuskan kolaborasi pada
dan untuk mendukung komunikasi dan koordinasi antara pemilik Bazel,
pengelola, dan kontributor. Kebijakan ini
berlaku untuk bazelbuild
.
SIG melakukan pekerjaan
mereka di depan umum. Ruang lingkup yang ideal untuk SIG
mencakup ruang lingkup yang terdefinisi dengan baik
yang sebagian besar partisipasinya berasal dari komunitas. SIG mungkin
fokus pada repositori yang dikelola komunitas di bazelbuild
(seperti bahasa
aturan) atau fokus pada area kode di repositori Bazel (seperti Remote
Eksekusi).
Meskipun tidak semua SIG akan memiliki tingkat energi, cakupan yang luas, atau model tata kelola yang sama, harus ada bukti yang memadai bahwa ada anggota komunitas yang bersedia berinteraksi dan berkontribusi jika grup minat dibentuk. Sebelum bergabung, tinjau tugas grup, lalu hubungi dengan pimpinan SIG. Kebijakan keanggotaan bervariasi berdasarkan SIG.
Lihat daftar lengkap SIG Bazel.
Non-tujuan: Yang bukan dengan SIG
SIG dimaksudkan untuk memfasilitasi kolaborasi pada pekerjaan bersama. Oleh karena itu, SIG adalah:
- Bukan forum dukungan: milis dan SIG bukanlah hal yang sama
- Tidak segera diperlukan: di awal kehidupan project, Anda mungkin tidak tahu jika Anda memiliki pekerjaan atau kolaborator bersama
- Bukan tenaga kerja gratis: energi diperlukan untuk mengembangkan dan mengoordinasikan pekerjaan secara kolaboratif
Pemilik Bazel mengambil pendekatan konservatif terhadap pembuatan SIG—berkat kemudahan memulai proyek di GitHub, ada banyak cara di mana kolaborasi dapat terjadi tanpa memerlukan SIG.
Siklus proses SIG
Bagian ini membahas cara membuat SIG.
Riset dan konsultasi
Untuk mengusulkan grup SIG baru, kumpulkan bukti untuk persetujuan terlebih dahulu, seperti yang ditentukan di bawah. Beberapa cara yang dapat dipertimbangkan adalah:
- Masalah atau serangkaian masalah yang terdefinisi dengan baik yang akan dipecahkan oleh kelompok
- Konsultasi dengan anggota komunitas yang akan mendapatkan manfaat, untuk menilai manfaat dan kesediaan mereka untuk
- Untuk project yang ada, bukti dari masalah dan PR bahwa kontributor tertarik dengan topik tersebut
- Tujuan potensial yang ingin dicapai grup
- Persyaratan resource untuk menjalankan grup
Bahkan jika kebutuhan akan SIG tampak jelas, penelitian dan konsultasi masih penting bagi keberhasilan grup.
Membuat grup baru
Grup baru harus mengikuti proses di bawah ini untuk menyewa. Secara khusus, laporan harus menunjukkan:
- Tujuan dan manfaat yang jelas bagi Bazel (baik seputar sub-proyek atau area penerapan)
- Dua atau lebih kontributor yang bersedia bertindak sebagai pemimpin kelompok, keberadaan kontributor, dan bukti permintaan terhadap grup tersebut
- Setiap grup harus menggunakan minimal satu milis yang dapat diakses secara publik. SIG dapat menggunakan kembali salah satu daftar publik, seperti bazel-discuss, minta daftar untuk @bazel.build, atau buat daftarnya sendiri
- Sumber daya yang awalnya diperlukan SIG (biasanya, milis dan melalui panggilan video.)
- SIG dapat menyalurkan dokumen
dan file dari direktorinya di
bazelbuild/community
atau dari repositori mereka sendiri dibazelbuild
GitHub organisasi/pengaturan. 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 diperlukan
Sebelum memasuki bagian formal dari proses, Anda harus berkonsultasi dengan tim produk Bazel, di product@bazel.build. Sebagian besar SIG membutuhkan percakapan dan iterasi sebelum disetujui.
Permintaan formal untuk grup baru dilakukan dengan mengirimkan piagam sebagai PR ke
bazelbuild/community
,
dan menyertakan permintaan dalam komentar pada PR dengan mengikuti template
di bawah. Setelah disetujui, PR untuk grup 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.
Charter
Untuk membentuk kelompok, Anda membutuhkan piagam dan harus mengikuti Bazel kode etik. Arsip grup akan bersifat publik. Keanggotaan mungkin terbuka untuk semua tanpa persetujuan, atau tersedia berdasarkan permintaan, menunggu persetujuan grup administrator.
Piagam harus menunjuk administrator. Selain sebagai administrator, grup harus menyertakan minimal satu orang sebagai pemimpin (ini boleh orang yang sama), yang berperan sebagai kontak (POC) untuk koordinasi sebagaimana diwajibkan dalam tim produk.
Kreator grup harus memposting piagam mereka ke milis grup. Repositori komunitas di organisasi GitHub Bazel mengarsipkan dokumen dan kebijakan tersebut. Saat grup mengembangkan praktik dan konvensi, mereka harus memperbarui piagam mereka pada bagian yang relevan dari repositori komunitas.
Kolaborasi dan inklusi
Meskipun tidak diwajibkan, kelompok harus memilih untuk memanfaatkan kolaborasi melalui panggilan konferensi terjadwal atau saluran obrolan untuk melakukan pertemuan. Seperti apa pun pertemuan harus diiklankan di milis, dan catatan yang diposting ke milis setelah itu. 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:
- Beri 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 menginformasikan aktivitas grup kepada komunitas Bazel yang lebih luas.
Jika SIG tidak lagi memiliki tujuan yang berguna atau komunitas yang tertarik, mungkin diarsipkan dan menghentikan operasi. Tim produk Bazel berhak untuk mengarsipkan SIG yang tidak aktif tersebut untuk menjaga kesehatan proyek secara keseluruhan, meskipun itu adalah hasil yang kurang disukai. SIG juga dapat memilih untuk membubarkan komputer menyadari bahwa penggunanya telah mencapai akhir masa pakainya.
Catatan
Konten ini telah diadopsi dari playbook SIG Tensorflow dengan modifikasi.