👩🏿‍🚀 🤧 🎧 GitHub पर पुल अनुरोध या मैं किसी और की परियोजना में कैसे बदलाव कर सकता हूं 🈁 🔄 🧑🏼‍🤝‍🧑🏼

Tulskiy के अनुरोध पर , मैं GitHub के आधिकारिक दस्तावेज फोर्क ए रेपो और सेंड पुल अनुरोधों के कुछ हिस्सों का मुफ्त अनुवाद कर रहा हूं।

तो, वास्तव में "शामिल किए जाने का अनुरोध (आपके परिवर्तनों का)" क्या है (कि मैंने कैसे पुल अनुरोध का अनुवाद किया है)? गिथुब का आधिकारिक दस्तावेज निम्नलिखित कहता है:

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

अपनी भाषा में बोलते हुए: आप एक पुल अनुरोध भेजकर, मूल भंडार के लेखक से (और सभी इच्छुक लोगों से) कहते हैं: "देखें कि मैंने क्या किया, क्या आप मेरे बदलावों को स्वीकार करना चाहते हैं और उन्हें परियोजना में डालना चाहते हैं?"

सहयोगी विकास मॉडल के बारे में थोड़ा सा

GitHub पर दो सहयोगी विकास मॉडल लोकप्रिय हैं:

Fork + Pull मॉडल किसी को भी मौजूदा रिपॉजिटरी को फोर्क करने और मूल रिपॉजिटरी को एक्सेस किए बिना अपने ही फोर्क में मर्ज करने की अनुमति देता है। फिर, परिवर्तनों को इसके मालिक द्वारा मूल भंडार में शामिल किया जाना चाहिए। यह मॉडल नए योगदानकर्ताओं के लिए आंदोलनों की संख्या को कम करता है और खुले स्रोत परियोजनाओं के लिए लोकप्रिय है, क्योंकि यह लोगों को स्वतंत्र रूप से काम करने की अनुमति देता है, एक भी समन्वय के बिना।
बंद परियोजनाओं पर काम करने वाली छोटी टीमों और संगठनों के बीच साझा रिपोजिटरी मॉडल अधिक आम है। टीम में सभी के पास एक सामान्य रिपॉजिटरी में "राइट" एक्सेस है, और विषय शाखाओं का उपयोग परिवर्तनों को अलग करने के लिए किया जाता है।

खींचे अनुरोध फोर्क + पुल मॉडल में विशेष रूप से उपयोगी होते हैं, क्योंकि वे रिपॉजिटरी की आपकी कॉपी में बदलावों के प्रोजेक्ट मेंटेनर्स (यानी मूल भंडार के मालिक) को सूचित करने का एक तरीका प्रदान करते हैं। हालांकि, वे सामान्य रिपॉजिटरी मॉडल में भी उपयोगी होते हैं, जहां आमतौर पर मुख्य विकास शाखा में इसे शामिल करने से पहले कोड की संशोधन या चर्चा शुरू करने के लिए उपयोग किया जाता है।

रिपॉजिटरी की कॉपी बनाना

पहले विकास मॉडल को ध्यान में रखते हुए, आपके पास मूल रिपॉजिटरी की अपनी प्रति होनी चाहिए, जिसमें कार्य किया जाएगा, और जिसमें से फिर मूल रिपॉजिटरी के लेखक को प्रस्ताव दिया जाएगा।

गाइड के भाग के रूप में, हम मान लेंगे कि हम ऑक्टोकैट उपयोगकर्ता के चम्मच-चाकू रिपॉजिटरी और आपके उपयोगकर्ता नाम के उपयोगकर्ता नाम पर काम कर रहे हैं।

ऐसा करना बहुत सरल है: रिपॉजिटरी पेज पर एक "फोर्क" बटन है, जिसे आपको क्लिक करना चाहिए।
कांटा बटन

उसके बाद, आप पहले से ही इस प्रतिलिपि को अपने कंप्यूटर पर "खींच" सकते हैं:

git clone git@github.com:username/Spoon-Knife.git

क्लोन रिपॉजिटरी में मूल नामक रिमोट रिपॉजिटरी के लिए एक बाइंडिंग है, जो आपकी कॉपी को GitHub पर इंगित करता है, और मूल रिपॉजिटरी को नहीं, इसमें परिवर्तन को ट्रैक करने के लिए, आपको एक और बाइंडिंग जोड़ने की आवश्यकता होगी, उदाहरण के लिए, अपस्ट्रीम।

 cd Spoon-Knife git remote add upstream git://github.com/octocat/Spoon-Knife.git git fetch upstream

काम करो

तो, इस बिंदु पर हम पहले से ही कोड को संपादित कर सकते हैं और कमिट कर सकते हैं। यदि आपने बाद के सभी चरणों को मूल भंडार में वापस करने के लिए किया है, तो मैं आपको दृढ़ता से सलाह देता हूं कि आप सभी कार्य विकास की एक अलग विषयगत शाखा में करें। पुल अनुरोध भेजने के चरण में इसकी उपयोगिता स्पष्ट हो जाएगी। इसे फीचर कहा जाए।

 git checkout -b feature #  ,  "feature"

अब, अच्छा करो (और इसे कमिट में व्यक्त किया जाए)।

एक बार जब आप काम (या इसका कुछ हिस्सा) कर लेते हैं, तो इसे GitHub पर रिपॉजिटरी की अपनी कॉपी पर भेजें:

 git push origin feature #      origin   feature

चेक इन: पुल अनुरोध

तो, सब कुछ किया जाता है। आपने कोड लिखा है, यह आपके कंप्यूटर और GitHub पर आपकी सुविधा शाखा में है। यह मूल भंडार में "भेजने" के लिए ही रहता है।

GitHub पर रिपॉजिटरी की अपनी कॉपी के पृष्ठ पर जाएं, सुविधा शाखा चुनें और Pull Request बटन पर क्लिक करें।
एक पुल अनुरोध के लिए तैयारी कर रहा है

अगला, आपको एक पूर्वावलोकन पृष्ठ पर ले जाया जाएगा, जिस पर आप अपना नाम और अपने परिवर्तनों का विवरण दर्ज कर सकते हैं (नाम फिर मर्ज कमेटी के विवरण में आता है और सार्वजनिक हो जाता है, इसे ध्यान में रखें)।
पुल अनुरोध का पूर्वावलोकन करें, नाम और विवरण भरें

पुल अनुरोध का पूर्वावलोकन करें, नाम और विवरण भरें

वहां आप देख सकते हैं कि पुल अनुरोध में कौन से कमिट आए:
पूर्वावलोकन पुल अनुरोध, करता है

और पुल अनुरोध में सभी परिवर्तनों का सामान्य अंतर भी:

डिफ़ॉल्ट रूप से, पुल अनुरोधों को मूल रिपॉजिटरी की सबसे अक्सर एकीकृत शाखा के आधार पर माना जाता है। इस मामले में, उपयोगकर्ता नाम / चम्मच-चाकू को ऑक्टोकैट / स्पून-नाइफ से कॉपी किया गया था, इसलिए पुल अनुरोध को ऑक्टोकैट / स्पून-नाइफ रिपॉजिटरी की मास्टर शाखा के आधार पर माना जाता है। ज्यादातर मामलों में, यह सही होगा, लेकिन यदि नहीं, तो आप "चेंज कमिट" बटन पर क्लिक कर सकते हैं

आपको आधार और स्रोत शाखाओं के चयन के लिए फॉर्म पर ले जाया जाएगा:
भेजने के लिए चयन करें

बाईं ओर, चुनें कि किस शाखा में मूल भंडार में परिवर्तन दाएं तरफ होगा, जो परिवर्तन आपके भंडार से लिया जाएगा। उदाहरण के लिए: दाईं ओर ऑक्टोकैट / चम्मच-चाकू / मास्टर, बाईं ओर उपयोगकर्ता नाम / चम्मच-चाकू / सुविधा। यहां आप न केवल शाखाओं को निर्दिष्ट कर सकते हैं, बल्कि संबंधित रिपॉजिटरी में व्यक्तिगत टैग और आईडी भी लिख सकते हैं।
महत्वपूर्ण : "मूल" भंडार के मालिक के साथ व्यवस्था करें कि आप किस शाखा में परिवर्तन अपलोड करेंगे (वह इसे README में लिख सकते हैं)

बेस रिपॉजिटरी को बदलने से उन लोगों की सूची भी बदल जाती है, जिन्हें पुल अनुरोध अधिसूचना प्राप्त होगी। बेस रिपॉजिटरी में "लिखने" का अधिकार रखने वाले हर व्यक्ति को एक पत्र प्राप्त होगा और मुख्य GitHub पर एक अधिसूचना दिखाई देगी, अगली बार जब वे इसे देखेंगे।
एक बार जब कमेटी सूची आपको संतुष्ट करती है, तो अपडेट कमिट रेंज बटन पर क्लिक करें।

जब आपने नाम और विवरण दर्ज किया और पुल अनुरोध में आने वाली फ़ाइलों के लिए आवागमन और परिवर्तनों की सूची को डबल-चेक किया, तो भेजें पुल अनुरोध बटन पर क्लिक करें। एक पुल अनुरोध तुरंत बनाया जाएगा।

आगे क्या है?

अपने पुल अनुरोध का ध्यान रखें। लोग इस पर क्या टिप्पणी करेंगे, अनुचर क्या कहेंगे, आपका पुल अनुरोध स्वीकार करेगा या नहीं।

याद रखें, मैंने कहा कि सभी परिवर्तन जो पुल पर जाते हैं, उन्हें एक अलग शाखा में रखा जाना चाहिए? तो, मुख्य सुविधा: आप हमेशा एक मौजूदा पुल अनुरोध पर कमेंट्स जोड़ सकते हैं, बस उन्हें अपने रिपॉजिटरी में इस शाखा में जोड़ सकते हैं (हाँ, सिर्फ git push origin feature , बशर्ते कि आप पुल अनुरोध में स्रोत शाखा के रूप में सुविधा निर्दिष्ट करें )

नाम, विवरण और कमिट के अलावा, पुल अनुरोध को देखने पर, निम्नलिखित भी प्रदर्शित होते हैं:

टिप्पणियाँ पुल अनुरोध के लिए छोड़ दिया;
अतिरिक्त अनुरोध पुल अनुरोध शाखा में जोड़ा गया;
पुल अनुरोधों में शामिल कमिट्स में से किसी में भी परिवर्तित लाइनों या फाइलों पर टिप्पणियाँ।

पुल अनुरोध के लिए टिप्पणियों में, आप मार्कडाउन का उपयोग कर सकते हैं, अर्थात, आप छवियों को सम्मिलित कर सकते हैं और मार्कडाउन द्वारा समर्थित सभी स्वरूपण का उपयोग कर सकते हैं।

जब आपका पुल अनुरोध स्वीकार कर लिया जाता है, तो अपने रिपॉजिटरी में परिवर्तनों को मर्ज करना न भूलें (या यदि आपको इसकी आवश्यकता नहीं है, तो इसे हटा दें):

 git checkout master git pull upstream master git push origin master

आप उस शाखा को भी हटा सकते हैं जिसमें विकास किया गया था:

 git branch -d feature #   git push origin :feature #

यदि काम में लंबा समय लगा हो और मूल भंडार आगे बढ़ने में कामयाब रहे तो क्या किया जाना चाहिए?

आप मूल रिपॉजिटरी से स्वयं में बदलावों को आसानी से धकेल सकते हैं:

 git checkout master git pull upstream master git checkout feature git merge master

हालांकि, मूल भंडार का मालिक, या शायद आप भी, हेज की उपस्थिति को पसंद नहीं करेंगे और खींचने के लिए कमिट की सूची में मास्टर से कमिट करता है। इस मामले में, आपको गिट रीबेस का उपयोग करना चाहिए।

 git checkout master git pull upstream master git checkout feature git rebase master #

आप इस बारे में पढ़ सकते हैं कि आधिकारिक गाइड में रिबास कैसे काम करता है। बहुत समझने योग्य चित्र भी हैं। GitHub की मदद पर एक लेख भी है।
ध्यान दें: कृपया ध्यान दें कि git rebase कमिट की आईडी बदल देता है! इसलिए, इस आदेश के साथ सभी क्रियाएं केवल स्थानीय भंडार पर ही की जानी चाहिए , इससे पहले कि ये सार्वजनिक रूप से उपलब्ध हो जाएं , अर्थात्। इससे पहले कि आप उन्हें जीथब पर धकेलें

यदि आप मेजबान हैं: पुल अनुरोध स्वीकार कैसे करें

यदि पुल अनुरोध सभी शर्तों को पूरा करता है, तो लक्ष्य रिपॉजिटरी में "राइट" (यानी वे पुश कर सकते हैं) के साथ किसी को कई तरीकों में से एक द्वारा अनुरोध स्वीकार करना चाहिए। तीन सबसे लोकप्रिय तरीके नीचे वर्णित हैं:

ऑटो मर्ज

कई मामलों में, आप बड़े हरे मर्ज पुल अनुरोध बटन का उपयोग करके जीथब को स्वचालित रूप से पुल अनुरोध को स्वीकार करने के लिए कह सकते हैं, जो परिवर्तनों को धक्का देगा, मर्ज कमिट बनाएगा और पुल अनुरोध को बंद करेगा।
ऑटो मर्ज बटन

अधिक जानकारी इस habratopike में पाया जा सकता है: GitHub पर मर्ज बटन ।

प्राप्त करें और मर्ज करें (डाउनलोड करें और मर्ज करें)

इंजेक्शन को बदलने की मुख्य विधि। इसके लिए रिमोट के अतिरिक्त की आवश्यकता होती है, जिससे उस व्यक्ति का भंडार भेजा जाता है जिसने पुल अनुरोध भेजा है, इस भंडार से परिवर्तन डाउनलोड कर रहा है, वांछित शाखा का विलय कर रहा है, संघर्षों को ठीक कर रहा है और अद्यतन शाखा को मूल भंडार में वापस अपलोड कर रहा है:

 git checkout master git remote add username git://github.com/username/Spoon-Knife.git git fetch username git merge username/feature git push origin master

पैच और लागू करें

पिछली विधि तब अच्छी तरह से काम करती है जब आप किसी टीम में काम करते हैं या लगातार एक ही समूह के लोगों से परिवर्तन स्वीकार करते हैं। एक अन्य विधि एकल मामलों में थोड़ा तेज है जब git-am का उपयोग कर रहा है।

प्रत्येक अनुरोध पुल पूल का अपना .patch URL होता है, जिसमें से आप इसे git-am कमांड में फीड करने के लिए एक टेक्स्ट पैच डाउनलोड कर सकते हैं:

 git checkout master curl https://github.com/octocat/Spoon-Knife/pull/50.patch | git am git push origin master

पुल अनुरोध बंद करना

गंतव्य अनुरोध भंडार में डाले गए अनुरोधों को खींचने पर अनुरोध स्वचालित रूप से बंद हो जाते हैं। इस मामले में, एक घटना सभी विकास प्रतिभागियों को सूचित करती है कि पुल अनुरोध को स्वीकार कर लिया गया है और मुख्य शाखा में डाल दिया गया है।
अनुरोध समापन कार्यक्रम का अनुरोध करें

यदि यह अस्वीकार कर दिया गया था तो पुल अनुरोध को मैन्युअल रूप से बंद करना भी संभव है। कभी-कभी यह उन मामलों में आवश्यक होता है जहां परिवर्तन को गिट-चेरी-पिक या किसी अन्य तंत्र का उपयोग करके स्वीकार किया गया था जो मर्ज का पता लगाने की अनुमति नहीं देता है।

एक निष्कर्ष के बजाय

मुझे आशा है कि यह मार्गदर्शिका आपको कई ओपन-सोर्स (और अधिक) प्रोजेक्ट्स को बेहतर बनाने में मदद करती है।
लंबे समय तक हाबराहाब पर बिताए जाने के बावजूद, यह मेरा पहला विषय है। कृपया पीएम में या उन सभी कमियों के बारे में टिप्पणी करें जो मैं कर सकता था। मैं इसे ठीक कर दूंगा।
इस तरह के एक सुविधाजनक और मुक्त खुले स्रोत सेवा के लिए, लेख को प्रकाशित करने में उनकी मदद के लिए, और निश्चित रूप से, GitHub विकास टीम के लिए एंटीऑक्‍ट्रिटेक और अन्य हैब्रुज़ के लिए बहुत धन्यवाद।

GitHub पर पुल अनुरोध या मैं किसी और की परियोजना में कैसे बदलाव कर सकता हूं