Belgelerde önerilen kuralların bir listesini sağlıyoruz.
Bu, kullanıcılarımıza iyi bir deneyim sağlayacak olan bir dizi yüksek kaliteli kuraldır. Desteklenen kurallar ile internette bulabileceğiniz yüzlerce kural arasında bir ayrım yaparız.
Adaylık
Aşağıdaki gereksinimleri karşılayan kural düzenleyiciler, GitHub sorunu oluşturarak bu grubu önerilen kurallara dahil olması için aday gösterebilir.
Bazel çekirdek ekibi tarafından incelendikten sonra bazel web sitesinde önerilecektir.
Kural koruyucular için gereksinimler
- Kural kümesi, çok sayıda Bazel kullanıcısının işine yarayan önemli bir özellik (örneğin, çok popüler olan bir dili destekleme) sağlar.
- Kural kümesi iyi korunuyor. En az iki etkin bakımcı olmalıdır.
- Kural kümesi, örneklerle iyi bir şekilde belgelenmiş ve kullanımı kolay.
- Kural kümesi, en iyi uygulamaları izler ve etkilidir (performans kılavuzunu inceleyin).
- Kural kümesi yeterli test kapsamına sahip.
- Kural kümesi, Bazel'in en son sürümüyle BuildKite'ta test edilmiştir. Testlerin her zaman başarılı olması gerekir (gönderme öncesi kontrolü olarak kullanıldığında).
- Kural grubu, yakında yapılacak uyumsuz değişikliklerle de test edilir. Arızalar iki hafta içinde düzeltilmelidir. Taşıma sorunları Bazel ekibine hızlı bir şekilde bildirilmelidir.
Bazel geliştiricileri için gereksinimler
- Önerilen kurallar, başı Bazel ile sık sık (günde en az bir kez) test edilir.
- Bazel'deki hiçbir değişiklik, önerilen bir kuralı (varsayılan işaret grubuyla) bozamaz. Böyle bir durumda, değişiklik düzeltilmeli veya geri çekilmelidir.
Sıralamasını düşürme
Belirli bir kural grubunun şartları artık karşılamadığına dair endişe varsa GitHub sorunu bildirilmelidir.
Kural sorumlularıyla iletişime geçilecek ve 2 hafta içinde yanıt vermeleri gerekecektir. Bazel çekirdek ekibi ortaya çıkan sonuca göre kural grubunun sıralamasını düşürmeye karar verebilir.