Grup Minat Khusus Bazel

Laporkan masalah Lihat sumber {/18/}{/1/}

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

SIG melakukan pekerjaan mereka di depan umum. Cakupan ideal untuk SIG mencakup domain yang terdefinisi 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, luas cakupan, atau model tata kelola yang sama, harus ada bukti yang memadai bahwa ada anggota komunitas yang bersedia untuk berinteraksi dan berkontribusi jika grup minat dibentuk. Sebelum bergabung, tinjau tugas grup, lalu hubungi pimpinan SIG. Kebijakan keanggotaan bervariasi per SIG.

Lihat daftar lengkap Bazel SIG.

Non-tujuan: Yang bukan dengan 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 kehidupan project, Anda mungkin tidak tahu apakah Anda memiliki pekerjaan atau kolaborator bersama
  • Bukan tenaga kerja bebas: energi diperlukan untuk mengembangkan dan mengoordinasikan pekerjaan secara kolaboratif

Bazel Owner mengambil pendekatan konservatif terhadap pembuatan SIG. Berkat kemudahan memulai project di GitHub, ada banyak cara untuk melakukan kolaborasi 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 ini. 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, menilai manfaat dan kesediaan mereka untuk berkomitmen
  • Untuk project yang ada, bukti dari isu dan PR yang menjadi perhatian kontributor tentang topik tersebut
  • Tujuan potensial yang dapat dicapai oleh grup
  • Persyaratan resource untuk menjalankan grup

Meskipun kebutuhan akan SIG tampak jelas, penelitian dan konsultasi masih penting bagi kesuksesan grup.

Buat grup baru

Grup baru harus mengikuti proses penyewaan grup di bawah ini. Secara khusus, contoh ini harus menunjukkan:

  • Tujuan dan manfaat yang jelas bagi Bazel (baik seputar area subproject atau aplikasi)
  • Dua kontributor atau lebih yang bersedia bertindak sebagai pemimpin grup, keberadaan kontributor lainnya, dan bukti permintaan terhadap 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 menyalurkan dokumen dan file dari direktorinya di bazelbuild/community atau dari repositorinya sendiri di organisasi GitHub bazelbuild. SIG dapat tertaut ke resource eksternal jika mereka memilih untuk mengatur pekerjaan mereka di luar organisasi GitHub bazelbuild
  • Pemilik Bazel menyetujui atau menolak permohonan SIG dan berkonsultasi dengan pemangku kepentingan lainnya jika perlu

Sebelum memasuki bagian formal, 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 charter sebagai PR ke bazelbuild/community, dan menyertakan permintaan tersebut dalam komentar pada PR dengan mengikuti template di bawah ini. Setelah disetujui, PR untuk grup tersebut 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.

Penyewaan

Untuk membentuk grup, Anda memerlukan piagam dan harus mengikuti kode etik Bazel. Arsip grup akan bersifat publik. Keanggotaan dapat terbuka untuk semua orang tanpa persetujuan, atau tersedia atas permintaan, sambil menunggu persetujuan dari administrator grup.

Piagam harus menunjuk administrator. Selain administrator, grup harus menyertakan minimal satu orang sebagai pemimpin (ini boleh orang yang sama), yang berperan sebagai kontak (POC) untuk koordinasi sebagaimana diwajibkan oleh tim produk Bazel.

Pembuat 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 di 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. Pertemuan seperti itu harus diiklankan di milis, dan setelah itu catatan diposting ke milis. Pertemuan rutin membantu mendorong akuntabilitas dan kemajuan dalam SIG.

Anggota tim produk Bazel dapat secara proaktif memantau dan mendorong kelompok untuk berdiskusi dan mengambil tindakan yang sesuai.

Meluncurkan SIG

Aktivitas yang diperlukan:

Aktivitas opsional:

  • Buat 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, untuk 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 dihentikan operasinya. Tim produk Bazel berhak mengarsipkan SIG yang tidak aktif tersebut guna menjaga kesiapan project secara keseluruhan, meskipun hasilnya kurang disukai. SIG juga dapat memilih untuk dibubarkan jika menyadari bahwa SIG telah mencapai akhir masa manfaatnya.

Catatan

Konten ini diadopsi dari playbook SIG Tensorflow dengan modifikasi.