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

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