Dalam dokumentasi, kami menyediakan daftar aturan yang direkomendasikan.
Ini adalah seperangkat aturan berkualitas tinggi, yang akan memberikan pengalaman baik pengguna. 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 menominasikan menjadi bagian dari aturan yang direkomendasikan dengan mengajukan Masalah GitHub.
Setelah ditinjau oleh tim inti Bazel, akan direkomendasikan di situs web Bazel.
Persyaratan untuk pengelola aturan
- Kumpulan aturan menyediakan fitur penting, yang berguna untuk sejumlah besar pengguna (misalnya, dukungan untuk bahasa yang sangat populer).
- Seperangkat aturan dikelola dengan baik. Setidaknya harus ada dua pengelola aktif.
- Kumpulan aturan tersebut didokumentasikan dengan baik, dilengkapi dengan contoh, dan mudah digunakan.
- Kumpulan aturan mengikuti praktik terbaik dan berperforma baik (lihat panduan performa).
- Kumpulan aturan memiliki cakupan pengujian yang memadai.
- Seperangkat aturan diuji pada BuildKite dengan Bazel versi terbaru. Pengujian harus selalu berhasil (bila digunakan sebagai pemeriksaan pra-pengiriman).
- Kumpulan aturan juga diuji dengan perubahan mendatang yang tidak kompatibel. Kerusakan akan 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 secara langsung (setidaknya sekali ).
- Tidak ada perubahan pada Bazel yang dapat melanggar aturan yang direkomendasikan (dengan kumpulan penanda). Jika ini terjadi, perubahan harus diperbaiki atau di-roll back.
Turun
Jika ada kekhawatiran bahwa kumpulan aturan tertentu tidak lagi memenuhi persyaratan, masalah GitHub harus diajukan.
Pengelola aturan akan dihubungi dan harus merespons dalam 2 minggu. Berdasarkan hasil akhir, tim inti Bazel mungkin membuat keputusan untuk mendemosikan kumpulan aturan tersebut.