Önerilen Kurallar

Sorun bildirin Kaynağı göster

Dokümanlarda, önerilen kuralların listesi verilmiştir.

Bu, kullanıcılarımıza iyi bir deneyim sunacak bir dizi yüksek kaliteli kuraldır. Desteklenen kurallar ile internette bulabileceğiniz yüzlerce kural arasında ayrım yaparız.

Adaylık

Bir kural grubu aşağıdaki gereksinimleri karşılıyorsa bir kural sorumlusu, GitHub sorunu göndererek önerilen kuralların bir parçası olarak aday gösterebilir.

Bazel temel ekibi tarafından yapılan incelemenin ardından, Bazel web sitesinde önerilecek.

Kural sorumluları için gereksinimler

  • Kural grubu, çok sayıda Bazel kullanıcısı için yararlı olan önemli bir özellik sağlar (örneğin, çok kullanılan bir dil desteği).
  • Kural kümesi iyi durumda. En az iki aktif operatör olmalıdır.
  • Kural grubu iyi belgelenmiş, örneklerle verilmiş ve kullanımı kolaydır.
  • Kural kümesi en iyi uygulamaları izler ve performansı gösterir (performans kılavuzuna bakın).
  • Kural kümesi yeterli test kapsamına sahiptir.
  • Kural grubu, Bazel'ın en son sürümüyle BuildKite'te test edilmiştir. Testler her zaman geçilmelidir (ön gönderim kontrolü olarak kullanıldığında).
  • Kural kümesi, yakında yapılacak uyumsuz değişikliklerle de test edilir. Kesintiler iki hafta içinde düzeltilmelidir. Taşıma sorunları hızlı bir şekilde Bazel ekibine bildirilmelidir.

Bazel geliştiricileri için şartlar

  • Önerilen kurallar yaygın olarak günde bazda test edilir (günde en az bir kez).
  • Bazel'da yapılan hiçbir değişiklik önerilen bir kuralı bozamaz (varsayılan işaret grubuyla). Bu durumda, değişiklik düzeltilmeli veya geri çekilmelidir.

Sıralama düşürme

Belirli bir kural grubunun artık gereksinimleri karşılamadığı konusunda endişeniz varsa bir GitHub sorunu bildirilmelidir.

Kural denetleyicilerle iletişime geçilecek ve 2 hafta içinde yanıt verilmesi gerekecek. Sonuçlara göre, Bazel temel ekibi kural grubunun sıralamasını düşürmeye karar verebilir.