Grup Minat Khusus Bazel

Laporkan masalah Lihat sumber

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

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

Lihat daftar lengkap Bazel SIG.

Non-sasaran: SIG

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

  • Bukan forum dukungan: milis dan SIG tidak sama
  • Tidak langsung diperlukan: sejak awal kehidupan project, Anda mungkin tidak tahu apakah Anda telah membagikan pekerjaan atau kolaborator
  • Bukan tenaga kerja gratis: diperlukan energi untuk mengembangkan dan mengoordinasikan pekerjaan secara kolaboratif

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

  • Soal yang jelas atau sekumpulan masalah yang akan diselesaikan grup
  • Konsultasi dengan anggota komunitas yang akan mendapatkan manfaat, menilai manfaat dan kemauan untuk berkomitmen
  • Untuk proyek yang ada, bukti dari masalah dan PR bahwa kontributor peduli dengan topik tersebut
  • Potensi sasaran yang ingin dicapai grup
  • Persyaratan resource dalam menjalankan grup

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

Buat grup baru

Grup baru harus mengikuti proses penyewaan. Khususnya, aplikasi ini harus menunjukkan:

  • Tujuan dan manfaat yang jelas bagi Bazel (sekitar sub-project atau area aplikasi)
  • Dua kontributor atau lebih bersedia untuk bertindak sebagai prospek grup, keberadaan kontributor lain, dan bukti permintaan 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 daftarnya sendiri
  • Resource yang awalnya diperlukan SIG (biasanya milis dan panggilan video reguler).
  • SIG dapat menayangkan dokumen dan file dari direktorinya di bazelbuild/community atau dari repositori mereka 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 dari proses ini, 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 charter sebagai PR ke bazelbuild/community, dan menyertakan permintaan dalam komentar di PR mengikuti template di bawah. Setelah disetujui, PR untuk grup digabungkan dan resource yang diperlukan dibuat.

Permintaan Template untuk SIG Baru

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

Penyewaan

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

Piagam tersebut harus menominasikan administrator. Selain administrator, grup harus menyertakan setidaknya satu orang sebagai prospek (orang ini mungkin orang yang sama), yang menjabat sebagai kontak (POC) untuk koordinasi seperti yang diwajibkan dengan tim produk Bazel.

Kreator grup harus memposting piagam mereka ke milis grup. Repositori komunitas di organisasi Bazel GitHub mengarsipkan dokumen dan kebijakan tersebut. Saat grup mengembangkan praktik dan konvensi, mereka harus memperbarui piagam mereka di bagian repositori repositori komunitas yang relevan.

Kolaborasi dan inklusi

Meskipun tidak diamanatkan, grup harus memilih untuk menggunakan kolaborasi melalui panggilan konferensi terjadwal atau saluran chat untuk melakukan rapat. Rapat tersebut harus diiklankan dalam 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.

Luncurkan SIG

Aktivitas yang diperlukan:

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 prospek SIG untuk melaporkan pekerjaan SIG, untuk memberi tahu komunitas Bazel yang lebih luas tentang aktivitas grup.

Jika SIG tidak lagi memiliki tujuan yang bermanfaat atau komunitas yang berminat, SIG dapat diarsipkan dan berhenti beroperasi. Tim produk Bazel berhak mengarsipkan SIG tidak aktif tersebut untuk mempertahankan kondisi project secara keseluruhan, meskipun hasilnya tidak terlalu bagus. SIG juga dapat memilih untuk membubarkan jika mengungkapnya telah mencapai akhir masa pakainya.

Catatan

Konten ini telah diadopsi dari playbook SIG Tensorflow dengan modifikasi.