Bazel'e Katkıda Bulunma

Bazel projesine ve ekosistemine yardımcı olmanın birçok yolu vardır.

Geri bildirim gönderme

Bazel'ı kullanırken iyileştirilebilecek şeyler görebilirsiniz. Aşağıdaki durumlarda sorunları bildirerek yardımcı olabilirsiniz:

• Bazel kilitleniyor veya yalnızca bazel clean kullanılarak çözülebilen bir hatayla karşılaşıyorsunuz.
• Belgeler eksik veya net değil. Ayrıca, sayfanın sağ üst köşesindeki "Sorun oluştur" bağlantısını kullanarak görüntülediğiniz sayfadan sorunları bildirebilirsiniz.
• Bir hata mesajı iyileştirilebilir.

Topluluğa katılın

Aşağıdaki yöntemleri kullanarak Bazel topluluğuyla etkileşime geçebilirsiniz:

• Stack Overflow'da soruları cevaplama.
• Slack'teki diğer kullanıcılara yardımcı olma.
• Dokümanları iyileştirme veya katkıda bulunan örnekler.
• Örneğin, bir blogda veya sosyal medyada deneyiminizi ya da ipuçlarını paylaşmak.

Katkıda bulun

Bazel büyük bir projedir ve Bazel kaynak kodunda değişiklik yapmak zor olabilir.

Bazel ekosistemine şu yollarla katkıda bulunabilirsiniz:

• Pull taleplerine katkıda bulunarak kuralların korunmasına yardımcı olma.
• Yeni kurallar oluşturma ve bunları açık kaynaklı hale getirme.
• Taşıma araçları gibi Bazel ile ilgili araçlara yapılan katkılar.
• Diğer IDE'ler ve araçlarla Bazel entegrasyonunu iyileştirme.

Değişiklik yapmadan önce GitHub'da bir sorun oluşturun veya bazel-dev@ adresine e-posta gönderin.

En faydalı katkılar, hataları düzeltir veya özellik ekler (biçimsel, yeniden düzenleme veya "temizlik" değişiklikleri yerine). Değişikliğiniz, geriye dönük uyumluluk, taşınabilirlik ve bellek kullanımı ile performansı üzerindeki etkiyi göz önünde bulundurarak testler ve belgeler içermelidir.

Nasıl değişiklik göndereceğinizi öğrenmek için yama kabul etme işlemine bakın.

Bazel kod açıklaması

Bazel, birden fazla konumda kod içeren büyük bir kod tabanına sahiptir. Daha fazla bilgi için kod tabanı kılavuzuna bakın.

Bazel'ın düzeni aşağıdaki gibidir:

• İstemci kodu src/main/cpp dilinde ve komut satırı arayüzü.
• Protokol arabelleği src/main/protobuf dilinde.
• Sunucu kodu src/main/java ve src/test/java şeklindedir.
  • Çoğunlukla SkyFrame ve bazı yardımcı programlardan oluşan temel kod.
  • Yerleşik kurallar com.google.devtools.build.lib.rules ve com.google.devtools.build.lib.bazel.rules içindedir. Öncelikle Yazma Kurallarının Zorlukları hakkında bilgi edinebilirsiniz.
• Java yerel arayüzleri src/main/native dilinde.
• Derleme derlemesi bölümündeki listede dil desteği için çeşitli araçlar açıklanmaktadır.

Bazel'in kaynak kodu aranıyor

Bazel'in kaynak kodundan hızlıca arama yapmak için Bazel Code Search'ü kullanın. Bazel veri depolarında, dallarda ve dosyalarda gezinebilirsiniz. Ayrıca geçmiş, farklar ve suçlama bilgilerini de görüntüleyebilirsiniz. Daha fazla bilgi edinmek için Bazel Code Search Kullanıcı Kılavuzu'na göz atın.