Bazel प्रोजेक्ट और इकोसिस्टम को बेहतर बनाने के कई तरीके हैं.
सुझाव दें
Bazel का इस्तेमाल करते समय, आपको ऐसी चीज़ें मिल सकती हैं जिनमें सुधार किया जा सकता है. इन स्थितियों में, समस्याओं की शिकायत करके हमारी मदद की जा सकती है:
- Bazel क्रैश हो जाता है या आपको कोई ऐसा बग मिलता है जिसे सिर्फ़
bazel cleanका इस्तेमाल करके ठीक किया जा सकता है. - दस्तावेज़ पूरा नहीं है या साफ़ तौर पर नहीं लिखा गया है. जिस पेज को देखा जा रहा है उस पर मौजूद समस्याओं की शिकायत भी की जा सकती है. इसके लिए, पेज के सबसे ऊपर दाएं कोने में मौजूद "समस्या की शिकायत करें" लिंक का इस्तेमाल करें.
- किसी गड़बड़ी के मैसेज को बेहतर बनाया जा सकता है.
कम्यूनिटी में शामिल होना
Bazel कम्यूनिटी से इन तरीकों से जुड़ा जा सकता है:
- Stack Overflow पर सवालों के जवाब देकर.
- Slack पर अन्य उपयोगकर्ताओं की मदद करके .
- दस्तावेज़ों को बेहतर बनाकर या उदाहरण देकर.
- अपना अनुभव या सुझाव शेयर करके. जैसे, किसी ब्लॉग या सोशल मीडिया पर.
कोड में योगदान देना
Bazel एक बड़ा प्रोजेक्ट है. इसलिए, Bazel के सोर्स कोड में बदलाव करना मुश्किल हो सकता है.
Bazel के इकोसिस्टम में इन तरीकों से योगदान दिया जा सकता है:
- पुल अनुरोध सबमिट करके, नियमों को बनाए रखने वाले लोगों की मदद करके.
- नए नियम बनाकर और उन्हें ओपन सोर्स करके.
- Bazel से जुड़े टूल में योगदान देकर. जैसे, माइग्रेशन टूल.
- अन्य IDE और टूल के साथ Bazel के इंटिग्रेशन को बेहतर बनाकर.
कोई बदलाव करने से पहले, GitHub पर कोई समस्या सबमिट करें या bazel-discuss@ को ईमेल भेजें.
सबसे मददगार योगदान वे होते हैं जिनसे बग ठीक होते हैं या नई सुविधाएं जुड़ती हैं. न कि स्टाइल से जुड़े, रीफ़ैक्टरिंग या "साफ़-सफ़ाई" से जुड़े बदलाव. आपके बदलाव में टेस्ट और दस्तावेज़ शामिल होने चाहिए. साथ ही, बैकवर्ड-कम्पैटबिलटी, पोर्टेबिलिटी, और मेमोरी के इस्तेमाल और परफ़ॉर्मेंस पर पड़ने वाले असर को ध्यान में रखना चाहिए.
बदलाव सबमिट करने के तरीके के बारे में जानने के लिए, पैच स्वीकार करने की प्रोसेस देखें.
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में हैं. - Bazel को कंपाइल करने वाले सेक्शन में, भाषा के लिए अलग-अलग टूलिंग के बारे में बताया गया है.
Bazel के सोर्स कोड को खोजना
Bazel के सोर्स कोड को तुरंत खोजने के लिए, Bazel Code Search का इस्तेमाल करें. Bazel के रिपॉज़िटरी, ब्रांच, और फ़ाइलों पर नेविगेट किया जा सकता है. इतिहास, अंतर, और क्रेडिट की जानकारी भी देखी जा सकती है. ज़्यादा जानने के लिए, Bazel Code Search की उपयोगकर्ता गाइड देखें.