Dokümanlarda önerilen kuralların listesini sunuyoruz.
Bu, kullanıcılarımıza iyi bir deneyim sunacak yüksek kaliteli kurallar setidir. Desteklenen kurallar ile internette bulabileceğiniz yüzlerce kural arasında ayrım yaparız.
Adaylık
Bir kural grubu aşağıdaki şartları karşılıyorsa kural sorumlusu, GitHub sorunu oluşturarak bu kural grubunun önerilen kurallar arasına alınmasını isteyebilir.
Bazel çekirdek ekibi tarafından yapılan incelemenin ardından Bazel web sitesinde önerilir.
Kural bakıcılarıyla ilgili şartlar
- Kural grubu, çok sayıda Bazel kullanıcısı için yararlı olan önemli bir özellik sağlar (ör. yaygın olarak kullanılan bir dil için destek).
- Kural grubu iyi bir şekilde korunuyor. En az iki etkin bakımcı olmalıdır.
- Kurallar grubu, örneklerle birlikte iyi bir şekilde belgelenmiştir ve kullanımı kolaydır.
- Kural grubu, en iyi uygulamalara uygundur ve iyi performans gösterir (bkz. performans kılavuzu).
- Kural kümesi yeterli test kapsamına sahip.
- Kural grubu, Bazel'in en yeni sürümüyle BuildKite üzerinde test edilir. 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. Kırılmalar iki hafta içinde düzeltilmelidir. Taşıma sorunları Bazel ekibine hızlıca bildirilmelidir.
Bazel geliştiricileri için şartlar
- Önerilen kurallar, Bazel'in en son sürümüyle sık sık (en az günde bir kez) test edilir.
- Bazel'deki 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 grubunun artık şartları karşılamadığına dair endişe varsa GitHub'da sorun bildirilmelidir.
Kuralı koruyanlarla iletişime geçilir ve 2 hafta içinde yanıt vermeleri gerekir. Sonuca bağlı olarak Bazel çekirdek ekibi, kural kümesini düşürme kararı verebilir.