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