पैच स्वीकार करने की प्रोसेस

समस्या की शिकायत करें सोर्स देखें

इस पेज में बताया गया है कि योगदान देने वाले लोग, Basel कोड बेस का सुझाव किस तरह दे सकते हैं और कैसे बदलाव कर सकते हैं.

  1. बेज़ल में योगदान से जुड़ी नीति पढ़ें.
  2. अपने प्लान और डिज़ाइन की चर्चा करने के लिए, GitHub की समस्या बनाएं. व्यवहार में बदलाव करने या जोड़ने वाले पुल के अनुरोधों को ट्रैक करने के लिए, संबंधित समस्या की ज़रूरत होती है.
  3. अगर आपको बड़े बदलाव करने हैं, तो एक डिज़ाइन दस्तावेज़ लिखें.
  4. पक्का करें कि आपने योगदान देने वाले को लाइसेंस देने के लिए कानूनी समझौता पर हस्ताक्षर किया हो.
  5. सुविधा को लागू करने वाली एक git टिप्पणी तैयार करें. टेस्ट जोड़ना और दस्तावेज़ अपडेट करना न भूलें. अगर आपके बदलाव का असर लोगों को दिखता है, तो कृपया प्रॉडक्ट की जानकारी जोड़ें. अगर यह बदलाव काम नहीं करता है, तो नुकसान पहुंचाने वाले बदलावों को लागू करने के बारे में जानकारी देने वाली गाइड पढ़ें.
  6. GitHub पर पुल का अनुरोध बनाएं. अगर आप GitHub पर नए हैं, तो पुल के अनुरोधों के बारे में जानकारी पढ़ें. ध्यान दें कि हम बेज़ल रिपॉज़िटरी में ब्रांच बनाने की अनुमतियों पर पाबंदी लगा देते हैं. इसलिए, आपको डेटा स्टोर करने की जगह के अपने प्लैटफ़ॉर्म पर अपनी प्रतिबद्धता को लागू करना होगा.
  7. बेज़ल मेंटेनर को दो कामकाजी दिनों के अंदर (अमेरिका और जर्मनी में छुट्टियों को छोड़कर) आपको समीक्षक असाइन कर देना चाहिए. अगर इसके बाद भी आपको कोई समीक्षक असाइन नहीं किया जाता है, तो bazel-discuss@googlegroups.com पर ईमेल करके समीक्षा करने का अनुरोध किया जा सकता है.
  8. कोड की समीक्षा पूरी करने के लिए, समीक्षक के साथ काम करें. हर बदलाव के लिए, एक नई कमिट बनाएं और उसे पुश करके अपने पुल के अनुरोध में बदलाव करें. अगर समीक्षा में बहुत ज़्यादा समय लगता है (उदाहरण के लिए, अगर समीक्षक जवाब नहीं देता है), तो bazel-discuss@googlegroups.com पर ईमेल भेजें.
  9. आपकी समीक्षा पूरी हो जाने के बाद, Bagel मेंटेनर आपके पैच को Google के इंटरनल वर्शन कंट्रोल सिस्टम पर लागू कर देता है.

    इससे इंटरनल प्री-सबमिट चेक ट्रिगर होते हैं. इससे ज़्यादा बदलावों के सुझाव मिल सकते हैं. अगर आपने कोई प्राथमिकता नहीं बताई है, तो बदलाव को सबमिट करने वाला रखरखाव करने वाला टूल, कुछ ऐसे "छोटे" बदलाव जोड़ देता है जो डिज़ाइन पर असर नहीं डालते. जैसे, लिंटिंग. अगर ज़्यादा गहराई से बदलाव करना ज़रूरी है या आपको बदलावों को सीधे तौर पर लागू करना है, तो आपको और समीक्षक को समीक्षा वाली टिप्पणियों में अपनी प्राथमिकताओं के बारे में साफ़ तौर पर बताना चाहिए.

    इंटरनल सबमिशन के बाद, पैच को Git कमिट के तौर पर एक्सपोर्ट किया जाता है. इसके बाद, GitHub पुल अनुरोध बंद हो जाता है. सभी अंतिम बदलावों के लिए आपको ज़िम्मेदार माना जाएगा.