मर्ज प्रस्ताव
किसी ब्रांच के बदलाव दूसरी ब्रांच में पहुंचने से पहले उनकी समीक्षा के लिए कहें।
परिचय
मर्ज प्रस्ताव एक ब्रांच के बदलावों को दूसरी ब्रांच में मर्ज करने का अनुरोध रिकॉर्ड करता है और ऐसा होने से पहले टीम के सदस्य को डिफ़ देखने देता है। एजेंट का एडिट एक्सेस रखने वाला कोई भी व्यक्ति प्रस्ताव खोल सकता है, यहां तक कि ऐसी ब्रांच में भी जिसमें वह स्वयं मर्ज नहीं कर सकता। प्रस्ताव को मर्ज करने के लिए फिर भी टारगेट ब्रांच का राइट एक्सेस चाहिए, इसलिए किसी प्रोटेक्टेड ब्रांच पर हर कॉन्ट्रिब्यूटर को मर्ज अधिकार दिए बिना बदलाव पहुंचाने का तरीका प्रस्ताव है।
मर्ज प्रस्ताव सीधे ब्रांच मर्ज करने के ऊपर एक वैकल्पिक समीक्षा चरण जोड़ते हैं। अगर आपके पास टारगेट ब्रांच का राइट एक्सेस है और दूसरी राय की ज़रूरत नहीं है, तो सीधे मर्ज करें। जब आप पहले समीक्षा चाहते हैं या टारगेट ब्रांच प्रोटेक्टेड है और आपके पास उसका राइट एक्सेस नहीं है, तो प्रस्ताव खोलें।
उपलब्धता
मर्ज प्रस्ताव अल्फ़ा में हैं। जब किसी एजेंट की कई ब्रांच पर एक साथ काम चल रहा हो, तो यह ट्रैक करना मुश्किल हो जाता है कि कौन-सी ब्रांच मर्ज के लिए तैयार और सुरक्षित है। मर्ज प्रस्ताव टीम को ब्रांच के बदलावों की समीक्षा और चर्चा करने, ब्रांचों के बीच टेस्ट पास रेट की तुलना करने और ब्रांच की नवीनतम बातचीत देखने के लिए एक जगह देते हैं।
अल्फ़ा, GitHub पर पुल रिक्वेस्ट की तरह एजेंटों के लिए CI/CD-स्टाइल वर्कफ़्लो की दिशा में पहला कदम है। आने वाले हफ्तों में ये चीज़ें जोड़ी जाएंगी:
- किसी प्रस्ताव को मर्ज करने से पहले पास होने वाले अनिवार्य टेस्ट।
- खास रिव्यूअर्स से अप्रूवल मांगना।
- एजेंट के अलग-अलग हिस्सों के लिए ओनर्स कॉन्फ़िगर करना।
प्रस्ताव का लाइफ़साइकल
हर प्रस्ताव की इनमें से एक स्थिति होती है:
जब कोई प्रस्ताव खुला होता है, तो रिव्यूअर इनमें से एक फैसला देते हैं। किसी रिव्यूअर का सबसे हालिया फैसला, उसी रिव्यूअर के पिछले फैसले की जगह लेता है:
प्रस्ताव खोलना
जिस ब्रांच के बदलावों की समीक्षा करानी है, उससे प्रस्ताव खोलें:
ब्रांच सूची से
Proposals टैब से
एजेंट के Branches टैब में, सोर्स ब्रांच का विकल्प मेन्यू खोलें और Open merge proposal चुनें।
प्रस्ताव को एक शीर्षक, वैकल्पिक विवरण दें और एजेंट की दूसरी गैर-आर्काइव ब्रांचों में से एक टारगेट ब्रांच चुनें। प्रस्ताव खोलने से किसी भी ब्रांच में बदलाव नहीं होता; यह सिर्फ़ अनुरोध रिकॉर्ड करता है।
सोर्स और टारगेट ब्रांच के किसी जोड़े के लिए एक समय में अधिकतम एक खुला प्रस्ताव हो सकता है। उन्हीं दो ब्रांचों के बीच दूसरा प्रस्ताव खोलने से पहले मौजूदा प्रस्ताव बंद करें।
प्रस्ताव की समीक्षा करना
प्रस्ताव के पेज में ये टैब होते हैं:
परिचय
बदलाव
टेस्ट रन
बातचीत
विवरण, समीक्षा इतिहास और समीक्षा देने का फ़ॉर्म।
प्रस्ताव के लेखक को छोड़कर, एजेंट का एडिट एक्सेस रखने वाला कोई भी व्यक्ति वैकल्पिक कमेंट के साथ समीक्षा दे सकता है। कमेंट्स में मार्कडाउन सपोर्ट होता है।
प्रस्ताव मर्ज करना
प्रस्ताव को मर्ज करने पर, सीधे मर्ज करने जैसी ही ब्रांच मर्ज होती है, जिसमें कॉन्फ़्लिक्ट रिज़ॉल्यूशन और बाद में सोर्स ब्रांच को आर्काइव करने का विकल्प भी शामिल है। मर्ज होने से पहले, प्रस्ताव को ये शर्तें पूरी करनी होंगी:
- मर्ज करने वाले यूज़र के पास सोर्स और टारगेट, दोनों ब्रांच का राइट एक्सेस हो। प्रोटेक्टेड ब्रांच पर, इसका मतलब वर्कस्पेस एडमिन होना है।
- किसी भी रिव्यूअर का सबसे हालिया फैसला “बदलावों का अनुरोध” न हो। बदलावों का अनुरोध करने वाले रिव्यूअर को प्रस्ताव मर्ज होने से पहले अप्रूव करना होगा।
- प्रस्ताव में उसके लेखक के अलावा किसी अन्य व्यक्ति का कम से कम एक अप्रूवल हो। वर्कस्पेस एडमिन इस अप्रूवल के बिना भी मर्ज कर सकते हैं।
प्रस्ताव को मर्ज करने पर उसी सोर्स ब्रांच के अन्य खुले प्रस्ताव अपने-आप बंद हो जाते हैं, क्योंकि उसके बदलाव अब आगे बढ़ चुके हैं।
प्रस्ताव बंद करना
प्रस्ताव खुला होने पर उसे कभी भी बिना मर्ज किए बंद किया जा सकता है। लेखक और रिव्यूअर बंद होने तक उसका शीर्षक और विवरण एडिट कर सकते हैं।
- लेखक द्वारा अपना प्रस्ताव बंद करने पर यह वापस लिया गया के रूप में रिकॉर्ड होता है।
- किसी अन्य व्यक्ति द्वारा बंद करने पर यह अस्वीकृत के रूप में रिकॉर्ड होता है।
- सोर्स ब्रांच को आर्काइव करने पर उससे या उसकी ओर आने वाले सभी खुले प्रस्ताव अपने-आप बंद हो जाते हैं और branch_archived के रूप में रिकॉर्ड होते हैं।
मर्ज प्रस्ताव और ElevenAgents Architect
Architect आपके लिए मर्ज प्रस्ताव खोल सकता है। किसी ब्रांच पर बदलाव करने और टेस्ट करने के बाद, यह ब्रांच के कमिट और मर्ज प्रीव्यू को पढ़ता है और Summary, Testing, और How to review सेक्शन के साथ प्रस्ताव खोलता है। यह आपके चुनने के लिए रिव्यूअर्स का सुझाव भी दे सकता है। चूंकि Architect आपकी तरह काम करता है, प्रस्ताव में आपको लेखक के रूप में दिखाया जाता है।
Architect किसी प्रस्ताव की समीक्षा, अप्रूव, मर्ज या उसे बंद नहीं कर सकता। ये चरण हमेशा लोग ही करते हैं। पूरी प्रक्रिया के लिए प्रस्ताव और वैलिडेशन देखें।