एक पुल अनुरोध (पीआर) एक गिटहब सुविधा है जो आपको उस भंडार में परिवर्तन प्रस्तावित करने की अनुमति देती है जिसके लिए आपके पास लेखन पहुंच नहीं है। रिपॉजिटरी मेंटेनर इन परिवर्तनों की समीक्षा कर सकते हैं और यदि वे चुनते हैं, तो उन्हें मूल रिपॉजिटरी में मर्ज कर सकते हैं।
गिटहब पर पुल अनुरोध खोलना ओपन-सोर्स परियोजनाओं में योगदान देने और अन्य डेवलपर्स के साथ सहयोग करने में महत्वपूर्ण है। गिटहब पर कुछ आसान चरणों में पुल अनुरोध बनाने और खोलने का तरीका जानें।
चरण 1: रिपॉजिटरी को फोर्क करना
एक रिपॉजिटरी फोर्किंग पर गिटहब मंच आपके खाते के अंतर्गत उस रिपॉजिटरी की एक प्रतिलिपि बनाता है—अन्यथा "फोर्क" के रूप में जाना जाता है। रिपॉजिटरी को फोर्क करने से आप मूल रिपॉजिटरी को प्रभावित किए बिना कोड में बदलाव कर सकते हैं।
रिपॉजिटरी को फोर्क करने के लिए, इसके मुख्य पृष्ठ पर नेविगेट करें और क्लिक करें काँटा ऊपरी दाएं कोने में बटन:
रिपॉजिटरी नाम (कांटा) और एक वैकल्पिक विवरण भरें और क्लिक करें कांटा बनाएँ:
अब आपने मूल रिपॉजिटरी की एक प्रति बना ली है। इस नए रिपॉजिटरी का मूल के साथ एक संबंध है ताकि आपके द्वारा कोड में किए गए किसी भी बदलाव की आसानी से तुलना की जा सके और उसमें वापस विलय किया जा सके।
चरण 2: संहिता में परिवर्तन करना
आपके द्वारा रिपॉजिटरी को फोर्क करने के बाद, आपको प्रस्तावित किए जाने वाले परिवर्तनों की मात्रा और प्रकृति के आधार पर इसे अपनी स्थानीय मशीन पर क्लोन करने की आवश्यकता हो सकती है। यदि आप बहुत ही सरल परिवर्तन कर रहे हैं जिन्हें आपको परीक्षण करने की आवश्यकता नहीं है, तो आप ऐसा ऑनलाइन उपयोग करके कर सकते हैं GitHub वेब-आधारित संपादक.
Git का उपयोग करके अपने स्थानीय मशीन पर रिपॉजिटरी को क्लोन करने के लिए, इस टर्मिनल कमांड को चलाएँ:
git क्लोन
बदलना अपने रिपॉजिटरी के URL के साथ—आप इसे GitHub पर पा सकते हैं। यह कमांड रिपॉजिटरी को आपकी स्थानीय मशीन पर क्लोन कर देगा, जहां आप स्वतंत्र रूप से प्रयोग कर सकते हैं और कोड में बदलाव कर सकते हैं।
आपको अपने परिवर्तनों को छोटा और केंद्रित रखना चाहिए, क्योंकि बड़े पुल अनुरोधों की समीक्षा करना और विलय करना चुनौतीपूर्ण हो सकता है। अपने परिवर्तनों को एक समस्या या सुविधा के लिए विशिष्ट रखने का प्रयास करें, ताकि अनुरक्षकों के लिए उनकी समीक्षा करना और उन्हें स्वीकार करना आसान हो सके।
स्थानीय रूप से अपने वांछित परिवर्तन करने के बाद, उन्हें कमिट करें और उन्हें अपने GitHub फोर्क में धकेलें गिट का उपयोग करना.
चरण 3: एक पुल अनुरोध खोलना
आपके द्वारा GitHub में अपने परिवर्तन किए जाने के बाद, आपको एक त्वरित चेतावनी दिखाई देनी चाहिए कि आपकी शाखा उस रिपॉजिटरी के आगे "कमिट" की संख्या है, जिसे आपने उदाहरण के लिए फोर्क किया था:
क्लिक करें योगदान देना ड्रॉप डाउन। इस बटन पर क्लिक करने से आपको एक पुल अनुरोध खोलने का संकेत मिलेगा। फिर, क्लिक करें ओपन पुल अनुरोध बटन:
कुछ रिपॉजिटरी में विशिष्ट योगदान दिशानिर्देश होते हैं, जिन्हें आप आमतौर पर एक CONTRIBUTING.md फ़ाइल में पा सकते हैं, जिसका आपको पालन करने की आवश्यकता होती है। पुल अनुरोध सबमिट करने से पहले इन दिशानिर्देशों को पढ़ना और उनका पालन करना सुनिश्चित करें।
अगला, आवश्यक फ़ील्ड भरें और पर क्लिक करें पुल अनुरोध बनाएँ बटन:
आपके द्वारा किए गए परिवर्तनों और उनके पीछे तर्क का वर्णन करते हुए आपका प्रतिबद्ध संदेश स्पष्ट और संक्षिप्त होना चाहिए। इससे अनुरक्षकों को आपके बदलावों को समझने में मदद मिलेगी और उनके लिए कोड की समीक्षा करना आसान हो जाएगा।
एक बार जब आप अपना पुल बना लेते हैं, तो आपको प्रोजेक्ट के अनुरक्षकों की समीक्षा करने और इसे मर्ज करने या इसे बंद करने की प्रतीक्षा करनी होगी। अनुरक्षकों के पास आपके पुल अनुरोध पर सुझाव या प्रतिक्रिया हो सकती है। परिवर्तनों के लिए खुले रहें और यदि वे आपसे पूछें तो संशोधन करने के लिए तैयार रहें।
पुल अनुरोधों का महत्व
पुल अनुरोध डेवलपर्स के बीच परिवर्तनों का प्रस्ताव करने, प्रतिक्रिया प्रदान करने और कोड की समीक्षा करने में सक्षम बनाकर सहयोग की सुविधा प्रदान करते हैं। यह एक परियोजना के भीतर समुदाय और सहयोग की भावना को बढ़ावा देने में मदद करता है, जिससे अधिक योगदान और तेजी से विकास होता है।
इसके अलावा, पुल अनुरोध अनुरक्षकों को कोड के विभिन्न संस्करणों और प्रत्येक संस्करण में किए गए परिवर्तनों का ट्रैक रखने की अनुमति देकर परियोजना के इतिहास और संस्करण को व्यवस्थित करते हैं।