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

किसी समस्या की शिकायत करें सोर्स देखें Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Bazel प्रोजेक्ट और उसके इकोसिस्टम की मदद करने के कई तरीके हैं.

सुझाव दें

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

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

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

Bazel कम्यूनिटी से जुड़ने के लिए:

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

कोड में योगदान देना

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

Bazel के नेटवर्क में योगदान देने के लिए, ये काम किए जा सकते हैं:

  • नियमों को बनाए रखने वाले लोगों की मदद करना. इसके लिए, उन्हें पुश अनुरोध भेजें.
  • नए नियम बनाना और उन्हें ओपन-सोर्स करना.
  • Bazel से जुड़े टूल में योगदान देना. जैसे, माइग्रेशन टूल.
  • अन्य आईडीई और टूल के साथ 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 में मौजूद हैं.
  • भाषा से जुड़ी सहायता के लिए, अलग-अलग टूल के बारे में Bazel को कॉम्पाइल करना सेक्शन में दी गई सूची में बताया गया है.

Bazel का सोर्स कोड खोजना

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