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

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 के लिए उपयोगकर्ता गाइड देखें.