Dokümanlarda önerilen kuralların listesi sunulmaktadır.
Bu, kullanıcılarımıza iyi bir deneyim sağlayacak yüksek kalite kurallarından oluşan bir gruptur. Desteklenen kurallar ile internette bulabileceğiniz yüzlerce kural arasında bir ayrım yapıyoruz.
Adaylık
Bir kural kümesi aşağıdaki şartları karşılıyorsa bir kural grubu, GitHub sorunu açarak onu önerilen kurallara dahil olması için aday gösterebilir.
Bazel çekirdek ekibinin incelemesinden sonra, bu öneri Bazel web sitesinde önerilecektir.
Kural sahipleri için gereksinimler
- Kural kümesi, çok sayıda Bazel kullanıcısı için yararlı olan önemli bir özellik sağlar (örneğin, yaygın olarak popüler bir dili destekler).
- Kural kümesi iyi korunuyor. En az iki etkin hesap sahibi olmalıdır.
- Kural seti, örneklerle iyi bir şekilde açıklanmış ve kullanımı kolay.
- Kural grubu, en iyi uygulamaları izler ve iyi performans gösterir (performans kılavuzuna bakın).
- Kural grubu, yeterli test kapsamına sahip.
- Kural kümesi, Bazel'in en son sürümüyle BuildKite'ta test edilmiştir. Testler her zaman başarılı olmalıdır (gönderme öncesi kontrol olarak kullanıldığında).
- Kural grubu, yakında kullanıma sunulacak uyumsuz değişikliklerle de test edilir. Arızalar iki hafta içinde düzeltilmelidir. Taşımayla ilgili sorunlar Bazel ekibine hızlı bir şekilde bildirilmelidir.
Bazel geliştiricileri için şartlar
- Önerilen kurallar, Bazel ile birlikte sık sık (günde en az bir kez) test edilir.
- Bazel'de yapılan hiçbir değişiklik, önerilen bir kuralı (varsayılan işaret grubuyla) bozamaz. Bu durumda, değişikliğin düzeltilmesi veya geri alınması gerekir.
Sıralama düşürme
Belirli bir kural grubunun artık gereksinimleri karşılamadığına dair endişeleriniz varsa bir GitHub sorunu kayda geçirilmelidir.
Kural sorumlularıyla iletişime geçilerek 2 hafta içinde yanıt verilmesi gerekir. Sonuca dayanarak, Bazel çekirdek ekibi kural grubunun sıralamasını düşürmeye karar verebilir.