Dokümanda, önerilen kuralların bir listesi sağlanmıştır.
Bu, kullanıcılarımıza iyi bir deneyim sunacak yüksek kaliteli kurallardan oluşan bir kurallar kümesidir. Desteklenen kurallar ile internette bulabileceğiniz yüzlerce kural arasında fark vardır.
Adaylık
Bir kural kümesi aşağıdaki koşulları karşılıyorsa kural yöneticisi, GitHub sorunu göndererek önerilen kurallar arasına dahil edilmesi için önerebilir.
Bazel çekirdek ekibi tarafından incelendikten sonra Bazel web sitesinde önerilir.
Kural koruyucuları için koşullar
- Kural kümesi, çok sayıda Bazel kullanıcısı için yararlı olan önemli bir özellik (ör. yaygın olarak kullanılan bir dil için destek) sağlar.
- Kural kümesi iyi yönetiliyor. En az iki etkin geliştirici olmalıdır.
- Kural kümesi, örneklerle birlikte iyi bir şekilde belgelenmiş ve kullanımı kolaydır.
- Kural kümesi en iyi uygulamalara uygundur ve yüksek performanslıdır (performans kılavuzuna bakın).
- Kural kümesi yeterli test kapsamına sahiptir.
- Kural kümesi, Bazel'in en son sürümüyle BuildKite'ta test edilir. Testler her zaman geçmelidir (göndermeden önce kontrol olarak kullanıldığında).
- Kural kümesi, uyumlu olmayan yaklaşan değişikliklerle de test edilir. Kesintiler iki hafta içinde düzeltilmelidir. Taşıma sorunları Basel ekibine hızlıca bildirilmelidir.
Bazel geliştiricileri için şartlar
- Önerilen kurallar, Bazel'in başında olduğu şekilde sık sık test edilir (en az günde bir kez).
- Bazel'de yapılan hiçbir değişiklik, önerilen bir kuralı (varsayılan işaret grubuyla) bozamaz. Bu durumda, değişiklik düzeltilmeli veya geri alınmalıdır.
Sıralamasını düşürme
Belirli bir kural kümesinin artık koşulları karşılamadığına dair endişeleriniz varsa GitHub sorunu kaydetmeniz gerekir.
Kuralların koruyucularıyla iletişime geçilir ve 2 hafta içinde yanıt vermeleri istenir. Bazel çekirdek ekibi, sonuca göre kural kümesinin sıralamasını düşürme kararı alabilir.