Dalam dokumentasi, kami memberikan daftar aturan yang direkomendasikan.
Kumpulan aturan ini berkualitas tinggi, yang akan memberikan pengalaman baik bagi pengguna kami. Kami membedakan antara aturan yang didukung dan ratusan aturan yang dapat Anda temukan di internet.
Nominasi
Jika kumpulan aturan memenuhi persyaratan di bawah ini, pengelola aturan dapat menominasikannya untuk menjadi bagian dari aturan yang direkomendasikan dengan mengajukan masalah GitHub.
Setelah ditinjau oleh tim inti Bazel, ulasan ini 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 dipertahankan dengan baik. Setidaknya harus ada dua pengelola aktif.
- Kumpulan aturan tersebut didokumentasikan dengan baik, beserta contohnya, dan mudah digunakan.
- Kumpulan aturan mengikuti praktik terbaik dan berperforma tinggi (lihat panduan performa).
- Kumpulan aturan memiliki cakupan pengujian yang memadai.
- Kumpulan aturan diuji di BuildKite dengan Bazel versi terbaru. Pengujian harus selalu lulus (jika digunakan sebagai pemeriksaan pra-pengiriman).
- Kumpulan aturan juga diuji dengan perubahan mendatang yang tidak kompatibel. Kerusakan harus diperbaiki dalam waktu dua minggu. Masalah migrasi harus dilaporkan ke tim Bazel dengan cepat.
Persyaratan untuk developer Bazel
- Aturan yang direkomendasikan sering diuji dengan Bazel di bagian kepala (setidaknya sekali sehari).
- Tidak ada perubahan di Bazel yang dapat melanggar aturan yang direkomendasikan (dengan sekumpulan tanda default). Jika hal ini terjadi, perubahan harus diperbaiki atau di-roll back.
Emosi
Jika ada masalah bahwa kumpulan aturan tertentu tidak lagi memenuhi persyaratan, masalah GitHub harus diajukan.
Pengelola aturan akan dihubungi dan harus merespons dalam 2 minggu. Berdasarkan hasil tersebut, tim inti Bazel mungkin membuat keputusan untuk mendemosikan kumpulan aturan.