Grup Minat Khusus Bazel

Laporkan masalah Lihat sumber Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

SIG melakukan pekerjaannya di tempat umum. 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, 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 pekerjaan grup, lalu hubungi pemimpin SIG. Kebijakan keanggotaan bervariasi berdasarkan SIG.

Lihat daftar lengkap SIG Bazel.

Bukan sasaran: Hal yang bukan merupakan 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 langsung diperlukan: di awal siklus proses project, Anda mungkin tidak tahu apakah Anda telah berbagi pekerjaan atau kolaborator
  • Bukan tenaga kerja gratis: energi diperlukan untuk mengembangkan dan mengoordinasikan pekerjaan secara kolaboratif

Pemilik Bazel menggunakan pendekatan konservatif untuk 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. Beberapa kemungkinan cara yang dapat dipertimbangkan adalah:

  • Masalah atau serangkaian masalah yang didefinisikan dengan baik yang akan dipecahkan 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 bahwa kontributor tertarik dengan topik tersebut
  • Tujuan potensial yang ingin dicapai grup
  • Persyaratan resource untuk menjalankan grup

Meskipun kebutuhan akan SIG tampak jelas, riset dan konsultasi masih penting untuk kesuksesan grup.

Membuat grup baru

Grup baru harus mengikuti proses di bawah ini untuk menyewa. Secara khusus, laporan harus menunjukkan:

  • Tujuan dan manfaat yang jelas untuk Bazel (baik di sekitar sub-project maupun area aplikasi)
  • Dua atau beberapa kontributor 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 daftarnya sendiri
  • Referensi yang awalnya diperlukan SIG (biasanya, milis dan panggilan video reguler).
  • SIG dapat menayangkan dokumen dan file dari direktorinya di bazelbuild/community atau dari repositorinya sendiri di organisasi GitHub bazelbuild. SIG dapat menautkan 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 diperlukan

Sebelum memasuki bagian formal proses, Anda harus berkonsultasi dengan tim produk Bazel, di product@bazel.build. Sebagian besar SIG memerlukan percakapan dan iterasi sebelum persetujuan.

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.

Template Permintaan untuk SIG Baru

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

Charter

Untuk membuat 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 berdasarkan permintaan, menunggu persetujuan administrator grup.

Piagam harus menominasikan administrator. Selain administrator, grup harus menyertakan setidaknya satu orang sebagai pimpinan (orang ini mungkin orang yang sama), yang berfungsi sebagai kontak untuk koordinasi sebagaimana diperlukan dengan tim produk Bazel.

Kreator 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 harus memperbarui piagamnya dalam bagian repositori komunitas yang relevan.

Kolaborasi dan inklusi

Meskipun tidak diwajibkan, grup harus memilih untuk menggunakan kolaborasi melalui panggilan konferensi terjadwal atau channel chat untuk melakukan 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:

  • Membuat postingan blog untuk blog Bazel

Kondisi dan penghentian SIG

Pemilik Bazel berupaya sebaik mungkin 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, SIG tersebut dapat diarsipkan dan menghentikan operasinya. 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 SIG tersebut menyadari bahwa SIG telah mencapai akhir masa manfaatnya.

Catatan

Konten ini telah diadopsi dari playbook SIG Tensorflow dengan modifikasi.