Aturan yang Direkomendasikan

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
Laporkan masalah Lihat sumber

Dalam dokumentasi, kami menyediakan daftar aturan yang direkomendasikan.

Ini adalah sekumpulan aturan berkualitas tinggi yang akan memberikan pengalaman yang baik bagi pengguna. Kami membuat perbedaan 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 Bazel core, ulasan akan direkomendasikan di situs Bazel.

Persyaratan untuk pengelola aturan

  • Kumpulan aturan memberikan fitur penting yang berguna bagi banyak pengguna Bazel (misalnya, dukungan untuk bahasa yang sangat populer).
  • Kumpulan aturan tersebut dikelola dengan baik. Setidaknya harus ada dua pengelola aktif.
  • Kumpulan aturan didokumentasikan dengan baik, disertai contoh, 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 versi terbaru Bazel. Pengujian harus selalu lulus (jika digunakan sebagai pemeriksaan pra-pengiriman).
  • Kumpulan aturan juga diuji dengan perubahan mendatang yang tidak kompatibel. Kerusakan akan diperbaiki dalam dua minggu. Masalah migrasi harus dilaporkan ke tim Bazel dengan cepat.

Persyaratan untuk developer Bazel

  • Aturan yang direkomendasikan sering diuji dengan Bazel di awal (setidaknya sekali sehari).
  • Tidak ada perubahan pada Bazel yang dapat melanggar aturan yang direkomendasikan (dengan sekumpulan tanda default). Jika terjadi, perubahan tersebut harus diperbaiki atau di-roll back.

Suasana hati

Jika terdapat masalah bahwa kumpulan aturan tertentu tidak lagi memenuhi persyaratan, masalah GitHub harus diajukan.

Pengelola aturan akan dihubungi dan harus merespons dalam 2 minggu. Berdasarkan hasilnya, tim inti Bazel dapat membuat keputusan untuk mendemosikan kumpulan aturan.