Bazel projesine ve ekosistemine yardımcı olmanın birçok yolu var.
Geri bildirim gönderme
Bazel'ı kullanırken iyileştirilebilecek şeyler bulabilirsiniz. Aşağıdaki durumlarda sorunları bildirerek yardımcı olabilirsiniz:
- Bazel kilitlenir veya yalnızca
bazel clean
kullanılarak çözülebilecek bir hatayla karşılaşırsınız. - Dokümanlar eksik veya net değil. Ayrıca, görüntülemekte olduğunuz sayfadaki sorunları, sayfanın sağ üst köşesindeki "Sorun oluştur" bağlantısını kullanarak bildirebilirsiniz.
- Hata mesajlarıyla ilgili iyileştirmeler yapılabilir.
Topluluğa katılın
Bazel topluluğuyla aşağıdaki şekillerde etkileşim kurabilirsiniz:
- Stack Overflow'da soruları cevaplayın.
- 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ızı paylaşma.
Katkıda bulunun
Bazel büyük bir projedir ve Bazel kaynak kodunda değişiklik yapmak zor olabilir.
Bazel ekosistemine şu yollarla katkıda bulunabilirsiniz:
- Pull isteklerine 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 katkıda bulunma
- Diğer IDE'ler ve araçlarla Bazel entegrasyonunu iyileştirme.
Değişiklik yapmadan önce bir GitHub sorunu oluşturun veya bazel-Tartışma@ adresine e-posta gönderin.
En faydalı katkılar, hataları düzeltir veya özellikler ekler (biçimlendirme, yeniden düzenleme veya "temizlik" değişikliklerinin aksine). Değişikliğiniz, geriye dönük uyumluluğu, taşınabilirliği 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'ın kod açıklaması
Bazel'ın, birden fazla konumda kod içeren büyük bir kod tabanı var. Daha fazla bilgi için kod tabanı rehberini inceleyin.
Bazel'ın düzeni aşağıdaki gibidir:
- İstemci kodu
src/main/cpp
dilindedir ve komut satırı arayüzünü sağlar. - Protokol arabellekleri
src/main/protobuf
dilindedir. - Sunucu kodu
src/main/java
vesrc/test/java
dilindedir.- Çoğunlukla SkyFrame ve bazı yardımcı programlardan oluşan temel kod.
- Yerleşik kurallar
com.google.devtools.build.lib.rules
vecom.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
dilindedir. - Dil desteği için çeşitli araçlar, Bazel derlemesi bölümündeki listede açıklanmıştır.
Bazel'ın kaynak kodu aranıyor
Bazel'ın kaynak kodunda hızlıca arama yapmak için Bazel Code Search'ü kullanın. Bazel'ın depolarında, şubelerinde ve dosyalarında gezinebilirsiniz. Ayrıca geçmişi, farkları ve suçlu bilgilerini de görüntüleyebilirsiniz. Daha fazla bilgi edinmek için Bazel Code Search Kullanıcı Rehberi'ne göz atın.