बज़ेल में योगदान

Bazel प्रोजेक्ट और नेटवर्क को आगे बढ़ाने के कई तरीके हैं.

सुझाव/राय देना या शिकायत करना

Bazel का इस्तेमाल करने पर, आपको ऐसी चीज़ें दिख सकती हैं जिन्हें बेहतर बनाया जा सकता है. आप समस्याओं की शिकायत कर सकते हैं, जब:

  • Bazel क्रैश हो जाता है या आपको कोई ऐसी गड़बड़ी मिलती है जिसे सिर्फ़ bazel clean का इस्तेमाल करके ठीक किया जा सकता है.
  • दस्तावेज़ अधूरा है या उसे साफ़ तौर पर नहीं बताया गया है. जिस पेज को देखा जा रहा है उससे भी समस्याओं की शिकायत की जा सकती है. इसके लिए, पेज के सबसे ऊपर दाएं कोने में मौजूद "समस्या बनाएं" लिंक का इस्तेमाल करें.
  • गड़बड़ी के मैसेज को बेहतर बनाया जा सकता है.

कम्यूनिटी में हिस्सा लेना

Bazel कम्यूनिटी के साथ जुड़ने के लिए, ये तरीके अपनाए जा सकते हैं:

  • Stack Overflow पर सवालों के जवाब देना.
  • Slack पर दूसरों की मदद करना.
  • दस्तावेज़ों में सुधार करना या उदाहरण देना.
  • अपना अनुभव या सलाह शेयर करना. उदाहरण के लिए, किसी ब्लॉग या सोशल मीडिया पर.

योगदान कोड

Bazel एक बड़ा प्रोजेक्ट है और Bazel के सोर्स कोड में बदलाव करना मुश्किल हो सकता है.

आप इन तरीकों से Bazel नेटवर्क में योगदान दे सकते हैं:

  • पुल के अनुरोधों का योगदान देकर, नियमों का पालन करने वाले लोगों की मदद करना.
  • नए नियम बनाना और उन्हें ओपन सोर्स करना.
  • Bazel से जुड़े टूल में योगदान देना. उदाहरण के लिए, माइग्रेशन टूल.
  • अन्य IDEs और टूल के साथ Bazel इंटिग्रेशन को बेहतर बनाना.

बदलाव करने से पहले, GitHub से जुड़ी समस्या बनाएं या bazel-dev@ पर ईमेल करें.

सबसे मददगार योगदानों से गड़बड़ियां ठीक की जाती हैं या सुविधाएं जोड़ी जाती हैं (स्टाइल, रीफ़ैक्टरिंग या "क्लीनअप" बदलाव के बजाय). पुराने सिस्टम के साथ काम करने की क्षमता, पोर्टेबिलिटी, और मेमोरी के इस्तेमाल और परफ़ॉर्मेंस पर पड़ने वाले असर को ध्यान में रखते हुए, आपके किए गए बदलाव में टेस्ट और दस्तावेज़ शामिल होने चाहिए.

बदलाव सबमिट करने का तरीका जानने के लिए, पैच स्वीकार करने की प्रोसेस देखें.

Bazel के कोड का ब्यौरा

Bazel का एक बड़ा कोड बेस है, जिसके कोड कई जगहों पर हैं. ज़्यादा जानकारी के लिए, कोड बेस की गाइड देखें.

Bazel को इस तरह व्यवस्थित किया गया है:

  • क्लाइंट कोड, src/main/cpp में है और कमांड-लाइन इंटरफ़ेस की सुविधा देता है.
  • प्रोटोकॉल बफ़र src/main/protobuf में हैं.
  • सर्वर का कोड src/main/java और src/test/java में है.
    • मुख्य कोड जिसमें SkyFrame और कुछ सुविधाएं मौजूद होती हैं.
    • बिल्ट-इन नियम com.google.devtools.build.lib.rules और com.google.devtools.build.lib.bazel.rules में हैं. शायद, आप सबसे पहले लिखने के नियमों की चुनौतियां के बारे में पढ़ना चाहेंगे.
  • Java के नेटिव इंटरफ़ेस, src/main/native में हैं.
  • भाषा पर काम करने के लिए इस्तेमाल होने वाले कई टूल के बारे में इस सूची में, Bzel को कंपाइल करने वाले सेक्शन में बताया गया है.

Bazel का सोर्स कोड खोजा जा रहा है

Bazel के सोर्स कोड को फटाफट खोजने के लिए, Bazel Code Search का इस्तेमाल करें. Bazel के डेटा स्टोर करने की जगहों, शाखाओं, और फ़ाइलों को नेविगेट किया जा सकता है. इसमें इतिहास, फ़र्क़, और दोषों के बारे में जानकारी भी देखी जा सकती है. ज़्यादा जानने के लिए, Bazel Code Search की इस्तेमाल के लिए गाइड देखें.