Dalam dokumentasi, kami menyediakan daftar aturan yang direkomendasikan.
Ini adalah kumpulan aturan berkualitas tinggi, yang akan memberikan pengalaman yang baik kepada pengguna kami. Kami membedakan antara aturan yang didukung, dan ratusan aturan yang dapat Anda temukan di Internet.
Nominasi
Jika kumpulan aturan memenuhi persyaratan, pengelola aturan dapat menominasikannya untuk menjadi bagian dari aturan yang direkomendasikan dengan mengajukan masalah GitHub.
Setelah ditinjau oleh tim inti Bazel, aturan tersebut akan direkomendasikan di situs Bazel.
Persyaratan untuk pengelola aturan
- Kumpulan aturan menyediakan fitur penting, yang berguna bagi banyak pengguna Bazel (misalnya, dukungan untuk bahasa yang sangat populer).
- Kumpulan aturan dikelola dengan baik. Harus ada minimal dua pengelola aktif.
- Kumpulan aturan didokumentasikan dengan baik, dengan contoh, dan mudah digunakan.
- Kumpulan aturan mengikuti praktik terbaik dan berperforma baik (lihat panduan performa).
- Kumpulan aturan memiliki cakupan pengujian yang memadai.
- Kumpulan aturan diuji di BuildKite dengan versi Bazel terbaru. Pengujian harus selalu lulus (saat digunakan sebagai pemeriksaan pra-commit).
- Kumpulan aturan juga diuji dengan perubahan yang tidak kompatibel yang akan datang. Kerusakan harus diperbaiki dalam waktu dua minggu. Masalah migrasi harus dilaporkan kepada tim Bazel dengan cepat.
Persyaratan untuk developer Bazel
- Aturan yang direkomendasikan sering diuji dengan Bazel di head (minimal sekali sehari).
- Tidak ada perubahan di Bazel yang dapat merusak aturan yang direkomendasikan (dengan kumpulan flag default). Jika hal ini terjadi, perubahan harus diperbaiki atau di-roll back.
Demosi
Jika ada kekhawatiran bahwa kumpulan aturan tertentu tidak lagi memenuhi persyaratan, masalah GitHub harus diajukan.
Pengelola aturan akan dihubungi dan harus merespons dalam waktu 2 minggu. Berdasarkan hasilnya, tim inti Bazel dapat membuat keputusan untuk mendemosi kumpulan aturan.