Önerilen Kurallar

Sorun bildir Kaynağı görüntüle Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Dokümanlarda önerilen kuralların listesini sunuyoruz.

Bu, kullanıcılarımıza iyi bir deneyim sunacak yüksek kaliteli kurallar dizisidir. 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 incelendikten sonra 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.
  • Kural 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 Rehberi).
  • Kural kümesi yeterli test kapsamına sahip olmalıdır.
  • Kural grubu, Bazel'in en son sürümüyle BuildKite'ta test edilir. Testler, her zaman başarılı olmalıdır (ön gönderme 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'de en son sürümle sık sık test edilir (en az günde bir kez).
  • 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.