Grup Minat Khusus Bazel

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

Bazel menghosting Special Interest Groups (SIG) untuk memfokuskan kolaborasi pada area tertentu dan mendukung komunikasi serta koordinasi antara pemilik Bazel, pengelola, dan kontributor. Kebijakan ini berlaku untuk bazelbuild.

SIG melakukan pekerjaannya secara publik. Cakupan ideal untuk SIG mencakup domain yang ditentukan dengan baik, dengan mayoritas 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, luas 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 dibuat. Sebelum bergabung, tinjau pekerjaan grup, lalu hubungi pemimpin SIG. Kebijakan keanggotaan berbeda-beda berdasarkan SIG.

Lihat daftar lengkap SIG Bazel.

Non-sasaran: Apa yang bukan SIG

SIG dimaksudkan untuk memfasilitasi kolaborasi dalam pekerjaan bersama. Oleh karena itu, SIG adalah:

  • Bukan forum dukungan: milis dan SIG adalah dua hal yang berbeda
  • Tidak segera diperlukan: pada awal masa aktif project, Anda mungkin tidak tahu apakah Anda memiliki pekerjaan atau kolaborator bersama
  • Bukan tenaga kerja gratis: energi diperlukan untuk mengembangkan dan mengoordinasikan pekerjaan secara kolaboratif

Pemilik Bazel mengambil pendekatan konservatif untuk pembuatan SIG—berkat kemudahan memulai project di GitHub, ada banyak cara kolaborasi dapat dilakukan 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 persetujuan, seperti yang ditentukan di bawah. Beberapa kemungkinan cara yang perlu dipertimbangkan adalah:

  • Masalah atau serangkaian masalah yang ditentukan 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 ada, bukti dari masalah dan PR yang menjadi perhatian kontributor
  • Potensi sasaran yang ingin dicapai grup
  • Persyaratan resource untuk menjalankan grup

Meskipun kebutuhan akan SIG tampak jelas, riset dan konsultasi tetap penting untuk keberhasilan grup.

Membuat grup baru

Grup baru harus mengikuti proses di bawah untuk pembuatan piagam. Secara khusus, grup baru harus menunjukkan:

  • Tujuan dan manfaat yang jelas untuk Bazel (baik di sekitar sub-project atau area aplikasi)
  • Dua kontributor atau lebih yang bersedia bertindak sebagai ketua grup, keberadaan kontributor lain, dan bukti permintaan untuk grup
  • Setiap grup harus 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 daftar sendiri
  • Resource yang awalnya diperlukan SIG (biasanya, milis dan panggilan video reguler).
  • SIG dapat menyajikan dokumen dan file dari direktori mereka di bazelbuild/community atau dari repositori mereka sendiri di bazelbuild GitHub organisasi. SIG dapat menautkan ke resource eksternal jika memilih untuk mengatur pekerjaan mereka di luar organisasi GitHub bazelbuild
  • 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 disetujui.

Permintaan formal untuk grup baru dilakukan dengan mengirimkan piagam sebagai PR ke bazelbuild/community, dan menyertakan permintaan dalam komentar di PR yang mengikuti template di bawah. Setelah disetujui, PR untuk grup akan digabungkan dan resource yang diperlukan akan dibuat.

Template Permintaan untuk SIG Baru

Untuk meminta SIG baru, gunakan template di repo komunitas: SIG-request-template.md.

Pembuatan piagam

Untuk membuat grup, Anda memerlukan piagam dan harus mengikuti kode etik Bazel code of conduct. Arsip grup akan bersifat publik. Keanggotaan dapat dibuka untuk semua orang tanpa persetujuan, atau tersedia berdasarkan permintaan, menunggu persetujuan administrator grup.

Piagam harus menunjuk administrator. Selain administrator, grup harus menyertakan setidaknya satu orang sebagai ketua (orang ini dapat menjadi orang yang sama), yang berfungsi sebagai titik kontak untuk koordinasi sesuai kebutuhan 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 piagam dalam bagian repositori komunitas yang relevan.

Kolaborasi dan inklusi

Meskipun tidak diwajibkan, grup harus memilih untuk menggunakan kolaborasi melalui panggilan konferensi terjadwal atau saluran chat untuk mengadakan rapat. Setiap rapat tersebut harus diiklankan di milis, dan catatan 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:

Aktivitas opsional:

  • Buat postingan blog untuk blog Bazel

Kesehatan dan penghentian SIG

Pemilik Bazel melakukan upaya terbaik untuk memastikan kesehatan SIG. Pemilik Bazel terkadang meminta ketua SIG untuk melaporkan pekerjaan SIG, guna memberi tahu komunitas Bazel yang lebih luas tentang aktivitas grup.

Jika SIG tidak lagi memiliki tujuan yang berguna atau komunitas yang tertarik, SIG dapat diarsipkan dan berhenti beroperasi. Tim produk Bazel berhak mengarsipkan SIG yang tidak aktif tersebut untuk mempertahankan kesehatan project secara keseluruhan, meskipun ini adalah hasil yang kurang disukai. SIG juga dapat memilih untuk dibubarkan jika menyadari bahwa SIG telah mencapai akhir masa aktifnya.

Catatan

Konten ini telah diadopsi dari playbook SIG Tensorflow dengan modifikasi.