पुल रिक्वेस्ट और कोड रिव्यू मीट्रिक्स
पूरा हुआ काम सबसे अधिक रिव्यू में प्रतीक्षा करता है, इसलिए मापें कि कोई बदलाव किसी के देखने से पहले कितनी देर पड़ा रहता है, वह कितना बड़ा है, और कितनी बार लौटकर आता है, और हर गति की संख्या को गुणवत्ता के संकेत से जोड़ें ताकि तेज़ का अर्थ कभी लापरवाह न हो।
अवलोकन और प्रेरणा
पुल रिक्वेस्ट (pull request) संस्करण नियंत्रण (version control) रिपॉज़िटरी की एक शाखा के बदलावों के सेट को दूसरी शाखा में मर्ज करने का प्रस्ताव है, साथ में इस बात की चर्चा कि उसे मर्ज किया जाए या नहीं। कई टीमों में यह "लेखक को लगता है कि यह चलता है" और "टीम सहमत है कि यह जा सकता है" के बीच औपचारिक द्वार है। यह चर्चा कोड रिव्यू (code review) का एक रूप है: लेखक के अलावा कोई व्यक्ति बदलाव पढ़ता है, प्रश्न पूछता है, और उसे स्वीकृत करता है या संशोधन माँगता है। कुछ प्लैटफ़ॉर्म इसे मर्ज रिक्वेस्ट कहते हैं; यह विषय दोनों के लिए "पुल रिक्वेस्ट" का उपयोग करता है।
रिव्यू को मापना एक सरल कारण से मूल्यवान है। डिलीवरी के प्रवाह-दृश्य में कार्य-मद अपने जीवन का अधिकांश भाग प्रतीक्षा में बिताती है, और रिव्यू उन प्रतीक्षाओं में से है जो पूरी तरह टीम के नियंत्रण में हैं। साझा प्लैटफ़ॉर्म की बाधा या बाहरी निर्भरता के लिए दूसरे लोगों को बदलना पड़ता है। जो पुल रिक्वेस्ट पहली नज़र के लिए दो दिन प्रतीक्षा करती है उसके लिए केवल टीम की अपनी आदतों को बदलना है। इस पुस्तक के प्रवाह-माप (देखें विषय 2.1, प्रवाह के माप, और विषय 2.2, लीड टाइम, साइकल टाइम और प्रवाह दक्षता) सामान्य शब्दावली देते हैं। यह विषय चक्र के एक चरण पर ज़ूम करता है और उसे अपने औज़ार देता है।
एजाइल और ITIL के दृष्टिकोण यहाँ उपयोगी ढंग से मिलते हैं। एजाइल दृष्टि से रिव्यू फीडबैक चक्र और सिखाने का तंत्र है। वह कोडबेस का ज्ञान फैलाता है, दोष जल्दी पकड़ता है, और टीम के कार्य-समझौतों और पूर्णता की परिभाषा को लागू करता है। ITIL दृष्टि से वही गतिविधि कई प्रैक्टिसों को सहारा देती है। ITIL 4 में सॉफ़्टवेयर विकास और प्रबंधन प्रैक्टिस कवर करती है कि सॉफ़्टवेयर कैसे बनता और जाँचा जाता है, परिवर्तन सक्षमीकरण कि परिवर्तनों का आकलन और प्राधिकरण कैसे होता है, और डिप्लॉयमेंट प्रबंधन कि परिवर्तन चालू परिवेश तक कैसे पहुँचते हैं। कई संगठनों के लिए सहकर्मी-समीक्षित पुल रिक्वेस्ट इसका प्रमाण है कि मानक परिवर्तन का आकलन रिलीज़ से पहले हुआ। रिव्यू को मापी जाने वाली, सुधारी जा सकने वाली गतिविधि मानना दोनों दृष्टिकोणों की सेवा करता है: एजाइल टीम तेज़ फीडबैक चाहती है, और ITIL प्रैक्टिस चाहती है कि भरोसेमंद आश्वासन हो कि परिवर्तन जाँचे गए।
पूरे समय ध्यान में रखने का जोखिम यह है कि रिव्यू की गति और रिव्यू की गुणवत्ता को अलग करना आसान है। टीम सब कुछ देखते ही स्वीकृत करके पहली समीक्षा का समय आधा कर सकती है, और डैशबोर्ड जीत दिखाएगा जबकि कोडबेस बिगड़ता है। गुडहार्ट का नियम (Goodhart's law) इस मीट्रिक परिवार पर असामान्य ज़ोर से लागू होता है (देखें विषय 1.2, गुडहार्ट का नियम और मीट्रिक्स का मनोविज्ञान), क्योंकि संख्याएँ जुटाने में सस्ती, सबको दिखाई देने वाली, और जिसका वे प्रतिनिधित्व करती हैं उसे बदले बिना हिलाने में बेहद आसान हैं। नीचे की हर सिफ़ारिश इसे ध्यान में रखकर लिखी गई है।
लेखक (author) ने पुल रिक्वेस्ट खोली और समीक्षक (reviewer) उसका आकलन करता है। रिव्यू का दौर "लेखक पुश करता है, समीक्षक उत्तर देता है" का एक चक्र है। पुनर्कार्य रिव्यू टिप्पणी के बाद या मर्ज के बाद किया गया वह बदलाव है जो पहले संस्करण की ग़लती सुधारता है। निरंतर एकीकरण (CI) काम को साझा रेखा में अक्सर मर्ज करने और हर मर्ज को अपने-आप जाँचने का अभ्यास है; देखें निरंतर एकीकरण (continuous integration)।
इस विषय की सभी मीट्रिक्स टीमों और रिपॉज़िटरियों का वर्णन करती हैं। वे समीक्षकों या लेखकों की रैंकिंग कभी नहीं करतीं। व्यक्ति-स्तर की रिव्यू गिनतियाँ निकालना आसान है और उनका उपयोग करने का लोभ होता है, और ऐसा करना सहयोग के अभ्यास को प्रतियोगिता बना देता है (देखें विषय 9.1, टीम स्वास्थ्य और डेवलपर अनुभव)।
मुख्य सिद्धांत
- प्रतीक्षा रिव्यू पर हावी है। अधिकांश टीमों में रिव्यू के समय का सबसे बड़ा हिस्सा पुल रिक्वेस्ट का अपठित पड़े रहना है, न कि समीक्षक के शुरू करने के बाद की चर्चा। बातचीत मापने से पहले प्रतीक्षा मापें।
- छोटे बदलाव तेज़ और बेहतर समीक्षित होते हैं। आकार उन थोड़े उपायों में है जो गति और गहराई दोनों एक साथ सुधारता है, क्योंकि समीक्षक छोटे बदलाव को दिमाग़ में रख सकता है।
- जाँच के बिना गति सुधार नहीं है। इस विषय के हर गति-माप को गुणवत्ता का साथी चाहिए, और जोड़ी साथ पढ़ी जाती है।
- रिव्यू टीम की क्षमता है, व्यक्तिगत नहीं। भार टीम में बँटना चाहिए। जो माप संकेंद्रण दिखाता है वह टीम की रचना की समस्या की ओर इशारा करता है, किसी व्यक्ति की प्रशंसा या दोष की ओर कभी नहीं।
- औसत से वितरण बेहतर। रिव्यू के समय की अटकी पुल रिक्वेस्टों की लंबी पूँछ होती है, इसलिए माध्य और ऊँचा परसेंटाइल रिपोर्ट करें (देखें विषय 1.6, सेवा मीट्रिक्स के लिए सांख्यिकीय साक्षरता)।
- घड़ी परिभाषित करें, फिर उसे छोड़ दें। बताएँ कि घड़ी कब शुरू और बंद होती है, कौन-सी घटनाएँ उसे रोकती हैं, और कौन-सी स्वचालित गतिविधि बाहर है, और यह वहाँ लिखें जहाँ डेटा रहता है (देखें विषय 1.5, डेटा स्रोत और इंस्ट्रूमेंटेशन)।
- रिव्यू मीट्रिक्स उस टीम की सेवा करती हैं जो काम की स्वामी है। वे टीम की अपनी रेट्रोस्पेक्टिव का इनपुट हैं, किसी और के लिए स्कोरकार्ड नहीं।
मीट्रिक परिभाषाएँ
नीचे की घड़ियाँ मानती हैं कि संस्करण नियंत्रण प्लैटफ़ॉर्म खोलने, रिव्यू के अनुरोध, टिप्पणियों, अनुमोदन, पुश और मर्ज की घटनाओं के समय दर्ज करता है। ड्राफ़्ट, बॉट द्वारा खोली गई पुल रिक्वेस्टें, और बिना मर्ज बंद की गई पुल रिक्वेस्टें शामिल नहीं हैं जब तक पंक्ति अन्यथा न कहे। "कार्य-घंटे" का अर्थ टीम के घोषित कार्य-घंटे हैं, ताकि शुक्रवार शाम को खुली पुल रिक्वेस्ट पर पूरे सप्ताहांत की प्रतीक्षा न जुड़े।
| मीट्रिक | परिभाषा | सूत्र | इकाई | डेटा स्रोत | ITIL प्रैक्टिस | एजाइल समकक्ष | आवृत्ति |
|---|---|---|---|---|---|---|---|
| पहली समीक्षा का समय | पुल रिक्वेस्ट के रिव्यू के लिए तैयार होने और पहली सारगर्भित मानवीय प्रतिक्रिया के बीच की प्रतीक्षा | घड़ी तब शुरू होती है जब पुल रिक्वेस्ट ड्राफ़्ट की स्थिति छोड़ती है या तैयार खोली जाती है, और लेखक के अलावा किसी की पहली रिव्यू टिप्पणी, बदलाव के अनुरोध या अनुमोदन पर रुकती है; बॉट और लेखक की टिप्पणियाँ और केवल लेबल के बदलाव शामिल नहीं। कार्य-घंटों में माध्य और 85वाँ परसेंटाइल रिपोर्ट करें | कार्य-घंटे | संस्करण नियंत्रण प्लैटफ़ॉर्म का घटना इतिहास | सॉफ़्टवेयर विकास और प्रबंधन; परिवर्तन सक्षमीकरण | रिव्यू की प्रतिक्रियाशीलता पर कार्य-समझौता; प्रगतिरत कार्य का प्रवाह | साप्ताहिक |
| रिव्यू साइकल टाइम | रिव्यू के लिए तैयार से मर्ज तक का कुल समय | घड़ी तब शुरू होती है जब पुल रिक्वेस्ट रिव्यू के लिए तैयार होती है, मर्ज पर रुकती है; बिना मर्ज बंद पुल रिक्वेस्टें शामिल नहीं और अलग से गिनी जाती हैं। कार्य-घंटों में माध्य और 85वाँ परसेंटाइल रिपोर्ट करें | कार्य-घंटे | संस्करण नियंत्रण प्लैटफ़ॉर्म का घटना इतिहास | डिप्लॉयमेंट प्रबंधन; परिवर्तन सक्षमीकरण | टीम बोर्ड पर रिव्यू चरण का साइकल टाइम | साप्ताहिक |
| पुल रिक्वेस्ट का आकार | पुल रिक्वेस्ट में बदलाव की मात्रा | जोड़ी गई पंक्तियाँ जमा हटाई गई पंक्तियाँ, रिपॉज़िटरी के ignore नियमों में सूचीबद्ध जनित फ़ाइलें, लॉक फ़ाइलें, वेंडर किया कोड और केवल नाम-परिवर्तन छोड़कर। प्रति मर्ज की गई पुल रिक्वेस्ट माध्य और 85वाँ परसेंटाइल रिपोर्ट करें | बदली पंक्तियाँ | संस्करण नियंत्रण प्लैटफ़ॉर्म के diff के आँकड़े | सॉफ़्टवेयर विकास और प्रबंधन | छोटे बैच का आकार; स्टोरियों की काट-छाँट | साप्ताहिक |
| रिव्यू के दौर | मर्ज से पहले लेखक के पुश और समीक्षक के उत्तर के चक्रों की संख्या | प्रति मर्ज की गई पुल रिक्वेस्ट अलग "बदलाव माँगे गए" या टिप्पणी-फिर-पुश चक्रों की गिनती; पहली प्रस्तुति शून्यवाँ दौर है और स्वचालित जाँच की विफलताएँ शामिल नहीं। माध्य और 85वाँ परसेंटाइल रिपोर्ट करें | गिनती | संस्करण नियंत्रण प्लैटफ़ॉर्म की रिव्यू और पुश घटनाएँ | सतत सुधार; सॉफ़्टवेयर विकास और प्रबंधन | रिव्यू चरण में पुनर्कार्य का संकेत; पूर्णता की परिभाषा | साप्ताहिक |
| रिव्यू भार का संकेंद्रण | टीम में रिव्यू का काम कितना असमान बँटा है | चलते 4 सप्ताहों में टीम की पूरी हुई रिव्यू का वह हिस्सा जिसे दो सबसे व्यस्त समीक्षकों ने संभाला; अपनी ही पुल रिक्वेस्ट की रिव्यू और बॉट रिव्यू शामिल नहीं। टीम के लिए रिपोर्ट, नाम से कभी नहीं | प्रतिशत | टीम में समेकित संस्करण नियंत्रण प्लैटफ़ॉर्म की रिव्यू घटनाएँ | सतत सुधार; ज्ञान प्रबंधन | साझा कोड स्वामित्व; सामूहिक स्वामित्व | मासिक |
| बासी पुल रिक्वेस्ट की गिनती | टीम की सहमत सीमा से अधिक देर से खुली पुल रिक्वेस्टें | अब भी खुली और ड्राफ़्ट में न होने वाली पुल रिक्वेस्टें जिनकी रिव्यू के लिए तैयार होने के बाद की आयु टीम की सीमा से अधिक है, स्नैपशॉट के समय गिनी गईं; ड्राफ़्ट शामिल नहीं | गिनती | संस्करण नियंत्रण प्लैटफ़ॉर्म की खुली पुल रिक्वेस्ट सूची | परिवर्तन सक्षमीकरण; सतत सुधार | कार्य-मद की आयु; WIP सीमा | साप्ताहिक |
| मर्ज के बाद सुधार की दर | मर्ज की गई पुल रिक्वेस्टों का हिस्सा जिनके तुरंत बाद सुधारात्मक बदलाव आया | मर्ज की गई पुल रिक्वेस्टें जिनके 14 दिन के भीतर उसी बदलाव से जुड़ा सुधार, रिवर्ट या हॉटफ़िक्स आया / अवधि में मर्ज की गई पुल रिक्वेस्टें; इस रूप में लेबल की गई नियोजित अनुवर्ती कार्रवाई शामिल नहीं | प्रतिशत | संस्करण नियंत्रण का इतिहास, जुड़े इश्यू, और घटना या परिवर्तन के रिकॉर्ड | परिवर्तन सक्षमीकरण; घटना प्रबंधन | अंतर्निहित गुणवत्ता; पूर्णता की परिभाषा | मासिक |
पहली समीक्षा का समय सबसे बड़ा उपाय है और वह माप जिससे अधिकांश टीमों को शुरू करना चाहिए। रिव्यू साइकल टाइम उसका परिणाम-माप है और विषय 2.2 में चर्चित लंबे लीड टाइम का घटक है। 14 दिन की खिड़की और बासी की सीमा उदाहरण हैं; हर टीम अपनी रिलीज़ की लय के अनुरूप मान चुनती है और लिख लेती है। जहाँ संख्याएँ व्यापक डिलीवरी की तस्वीर में जाती हैं, वहाँ DORA परिवार (देखें विषय 2.8, DORA मीट्रिक्स) और परिवर्तन विफलता के माप (देखें विषय 4.4, परिवर्तन की विफलता और पुनर्कार्य) सँभाल लेते हैं।
सिफ़ारिशें
काम से पहले प्रतीक्षा मापें
1. पहली समीक्षा के समय से शुरू करें। यह आमतौर पर रिव्यू के समय का सबसे बड़ा योगदानकर्ता है और सुधारने में सबसे सस्ता। इसे प्लैटफ़ॉर्म के घटना इतिहास से इंस्ट्रूमेंट करें ताकि किसी को कुछ दर्ज न करना पड़े। माध्य और ऊँचा परसेंटाइल रिपोर्ट करें, क्योंकि तीन घंटे का माध्य और चार दिन का 95वाँ परसेंटाइल बताता है कि कुछ बदलाव भुलाए जा रहे हैं।
2. बॉट और ड्राफ़्ट को घड़ी से बाहर रखें, और कहें कि ऐसा है। स्वचालित जाँचें, निर्भरता-अद्यतन करने वाले बॉट और फ़ॉर्मैटिंग औज़ार सेकंडों में टिप्पणियाँ बनाते हैं, और उन्हें गिनने से प्रतीक्षा बहुत अच्छी दिखती है। घड़ी तब शुरू करें जब लेखक बदलाव को तैयार चिह्नित करे, तब नहीं जब शाखा पहली बार पुश हो। ये नियम चार्ट के बगल में प्रकाशित करें।
3. कार्य-घंटों का उपयोग करें, और टीम का कैलेंडर लिखें। शुक्रवार को देर से खुली पुल रिक्वेस्ट पर सप्ताहांत की प्रतीक्षा नहीं जुड़नी चाहिए। समय-क्षेत्रों में फैली टीम को नियम चाहिए कि किसके घंटे गिने जाएँ, और अक्सर ईमानदार उत्तर यह है कि क्षेत्रों के पार हस्तांतरण की लागत ही देखने योग्य चीज़ है। चुनाव बताएँ और उसे स्थिर रखें।
काम को समीक्षा योग्य बनाएँ
4. पुल रिक्वेस्टें छोटी रखें, और आकार को टीम की आदत मानें। आकार का माध्य और 85वाँ परसेंटाइल ट्रैक करें, और बड़ी रिक्वेस्टों को अलग-अलग विफलताओं की जगह सेट के रूप में देखें। टीमें प्रायः पाती हैं कि बड़े बदलाव कुछ कारणों से आते हैं: काम को पर्याप्त बारीकी से न काटना, रीफ़ैक्टरिंग को नए व्यवहार से मिलाना, या मर्ज करने में बहुत देर करना। काम को ऐसे काटें कि हर पुल रिक्वेस्ट एक ही काम करे, जो ट्रंक-आधारित विकास (trunk-based development) और बार-बार डिप्लॉयमेंट के छोटे बैच के सिद्धांत से भी मेल खाता है।
5. कठोर आकार-सीमा को लक्ष्य न बनाएँ। "400 पंक्तियों से अधिक नहीं" जैसी सीमा बदलाव को कृत्रिम टुकड़ों में बाँटने को न्योता देती है जो अकेले अपठनीय हैं या अकेले मर्ज होने पर बिल्ड तोड़ देते हैं। आकार को रेट्रोस्पेक्टिव में बातचीत शुरू करने के लिए प्रयोग करें, और टीम को काटने की तकनीकें दें, जैसे फ़ीचर टॉगल, अपनी अलग पुल रिक्वेस्ट में तैयारी की रीफ़ैक्टरिंग, और झंडे के पीछे मर्ज करना।
6. रिव्यू का अनुरोध स्पष्ट करें। जो पुल रिक्वेस्ट किसी समीक्षक का नाम नहीं लेती वह स्वयंसेवक की प्रतीक्षा करती है, और स्वयंसेवक दुर्लभ हैं। कार्य-समझौते में तय करें कि किससे पूछा जाए, टीम को कैसे सूचित किया जाए, और उत्तर की अपेक्षा क्या है। साझा रिव्यू रोटा या दैनिक रिव्यू स्लॉट आमतौर पर किसी भी औज़ार की सेटिंग से अधिक प्रतीक्षा घटाता है।
भार और ज्ञान फैलाएँ
7. भार के संकेंद्रण को टीम-स्तर के जोखिम के रूप में देखें। यदि दो लोग अधिकांश रिव्यू संभालते हैं, तो उनकी उपलब्धता टीम के प्रवाह की सीमा बनती है, और उनकी अनुपस्थिति उसे रोकती है। संकेंद्रण के माप की मासिक समीक्षा करें, और टीम की रचना से कार्रवाई करें: डिफ़ॉल्ट समीक्षक को घुमाएँ, नए सदस्यों को अनुभवी सदस्यों के साथ जोड़ें, और कोड के वे क्षेत्र लिखें जिनकी रिव्यू केवल एक व्यक्ति कर सकता है। प्रति-व्यक्ति लीडरबोर्ड प्रकाशित न करें।
8. रिव्यू का उपयोग ज्ञान साझा करने के लिए करें, और उस उद्देश्य की रक्षा करें। रिव्यू के दीर्घकालिक मूल्य में दोष-पहचान के साथ सीखना, साझा स्वामित्व और एकसमान शैली शामिल हैं। पेयर प्रोग्रामिंग (pair programming) और मॉब प्रोग्रामिंग उस आदान-प्रदान का कुछ हिस्सा प्रक्रिया में पहले ले जाते हैं; जहाँ जोड़ी ने पहले ही बदलाव पर काम किया है, वहाँ हल्की रिव्यू उचित है। चुनाव टीम का निर्णय बनाएँ, कार्य-समझौते में लिखा हुआ, ताकि "जोड़ी में किया, इसलिए हल्की रिव्यू" दिखाई देने वाला नियम हो, बहाना नहीं।
रिव्यू को स्वयं नियंत्रित करें
9. स्वचालन को वह करने दें जो वह अच्छा करता है। फ़ॉर्मैटिंग, लिंटिंग और बुनियादी जाँचें पाइपलाइन में हैं, ताकि मानवीय ध्यान रचना, शुद्धता और जोखिम पर जाए। स्थैतिक प्रोग्राम विश्लेषण (static program analysis) और स्वचालित परीक्षण मामूली रिव्यू के दौर घटाते हैं। बचे हुए दौर फिर रचना की बातचीत के बारे में अधिक और शैली की असहमतियों के बारे में कम कहते हैं।
10. रिव्यू के दौर को स्पष्टता का संकेत पढ़ें, दोष की गिनती नहीं। कई दौर का अर्थ हो सकता है कि आवश्यकता अस्पष्ट थी, लेखक के पास संदर्भ नहीं था, समीक्षक ने पसंद के बदलाव माँगे, या बदलाव बड़ा था। हर पुल रिक्वेस्ट पर शून्य दौर का अर्थ उत्कृष्ट काम हो सकता है या यह कि किसी ने देखा नहीं। असामान्य रूप से अधिक या कम दौर वाली मुट्ठी भर पुल रिक्वेस्टों का नमूना लें और उन्हें टीम के रूप में साथ पढ़ें।
गति को गुणवत्ता से जोड़ें, और समय दिखाई देता रखें
11. रिव्यू की गति के बगल में हमेशा गुणवत्ता का साथी दिखाएँ। मर्ज के बाद सुधार की दर, हाल के बदलावों से जुड़ी घटनाएँ, और रिलीज़ के बाद मिले दोषों का हिस्सा स्वाभाविक साथी हैं (देखें विषय 4.4, परिवर्तन की विफलता और पुनर्कार्य)। यदि रिव्यू का समय सुधरे जबकि सुधार की दर बिगड़े, तो टीम ने आश्वासन गति से बदल दिया है, और उपाय बातचीत है, लक्ष्य नहीं। दोनों एक ही चार्ट पर दिखाएँ।
12. रिव्यू को प्रवाह की तस्वीर और अनियोजित काम से जोड़ें। तेज़ रिव्यू तभी मदद करती है जब अगला चरण काम को केवल कतार में न डाल दे (देखें विषय 2.3, प्रगतिरत कार्य और कतारें)। नियोजित काम को बाधित करने वाले तत्काल रिव्यू अनुरोधों की अपनी लागत है (देखें विषय 2.9, संचालन-कार्य और अनियोजित कार्य)।
गेमिंग के रास्ते और सुरक्षा-रेखाएँ
| मीट्रिक | इसमें गेमिंग कैसे होती है | जोड़ीदार सुरक्षा-रेखा मीट्रिक या प्रथा |
|---|---|---|
| पहली समीक्षा का समय | पहली प्रतिक्रिया के रूप में जल्दी "ठीक लगता है" या इमोजी देना; बॉट या मित्रवत समीक्षक नियुक्त करना; पुल रिक्वेस्ट को तब तैयार चिह्नित करना जब कोई पहले से देखने को सहमत हो चुका हो | मर्ज के बाद सुधार की दर; बिना टिप्पणी वाले अनुमोदनों का नमूना; कार्य-समझौते में पहली प्रतिक्रियाओं के सारगर्भित होने की शर्त |
| रिव्यू साइकल टाइम | रिव्यू की प्रतीक्षा किए बिना मर्ज करना; जल्दी पास कराने के लिए बदलाव को छोटे टुकड़ों में बाँटना; घड़ी शून्य करने के लिए पुल रिक्वेस्ट बंद करके दोबारा खोलना | बंद करके दोबारा खोली गई पुल रिक्वेस्टों की गिनती; रिव्यू के दौर; मर्ज के बाद सुधार की दर; अनुमोदन की आवश्यकता वाले संरक्षित शाखा के नियम |
| पुल रिक्वेस्ट का आकार | गिनती से फ़ाइलें बाहर रखना; एक बदलाव को ऐसे टुकड़ों में बाँटना जो अलग से समझे नहीं जा सकते; जनित कोड से आकार में पैडिंग | हर तिमाही ignore नियमों की समीक्षा; जाँचें कि बाँटे टुकड़े अकेले बिल्ड होते और परीक्षण पास करते हैं; सबसे छोटे और सबसे बड़े का नमूना पढ़ें |
| रिव्यू के दौर | गिनती कम रखने के लिए पहली ही बार में स्वीकृत करना; चर्चा को चैट में ले जाना ताकि कोई निशान न रहे; दौर छिपाने के लिए लेखक का एक कमिट में कई फ़िक्स-अप पुश करना | मर्ज के बाद सुधार की दर; शून्य-दौर वाली पुल रिक्वेस्टों का नमूना; चर्चा पुल रिक्वेस्ट में ही रखें |
| रिव्यू भार का संकेंद्रण | गिनती बाँटने के लिए रिव्यू को कई छोटे अनुमोदनों में तोड़ना; जिनके पास समय है पर ज्ञान नहीं उन्हें रिव्यू सौंपना | जोखिम भरे क्षेत्रों के लिए समीक्षक के ज्ञान की समीक्षा; क्षेत्र के अनुसार मर्ज के बाद सुधार की दर देखें; माप टीम-स्तर पर रखें |
| बासी पुल रिक्वेस्ट की गिनती | बासी पुल रिक्वेस्टें बिना मर्ज बंद करना; उन्हें छिपाने के लिए ड्राफ़्ट में बदलना; बासी की सीमा बढ़ाना | बिना मर्ज बंद पुल रिक्वेस्टों की गिनती; लंबे समय से चल रहे ड्राफ़्टों की गिनती; हर तिमाही टीम के साथ सीमा की समीक्षा |
| मर्ज के बाद सुधार की दर | सुधार को बिना कड़ी के नए कार्य-मद के अंतर्गत दर्ज करना; सुधारात्मक काम को नियोजित अनुवर्ती के रूप में लेबल करना; सुधार को खिड़की के बाद टालकर माप से बचना | घटना और परिवर्तन विफलता के डेटा से तुलना करें; अनुवर्ती मदों का नमूना; प्रयुक्त लेबलों का ऑडिट |
स्वस्थ पठन शांत होता है। पहली समीक्षा का समय छोटा है और पूँछ भी छोटी है, इसलिए कोई पुल रिक्वेस्ट दिनों प्रतीक्षा नहीं करती। आकार उस सीमा में है जिसे टीम पढ़ने में आसान पाती है, कुछ बड़े बदलावों के साथ जिन्हें टीम समझा सकती है। रिव्यू के दौर कम हैं पर शून्य नहीं, भार का संकेंद्रण मध्यम है, बासी गिनती छोटी है, और मर्ज के बाद सुधार की दर स्थिर है। जब कोई एक संख्या तेज़ी से सुधरे, तो कोई जाँचे कि उसकी जोड़ीदार सुरक्षा-रेखा ग़लत दिशा में तो नहीं गई।
समझौते: लाभ और हानि
| तरीका | ताकत | कमज़ोरी |
|---|---|---|
| कड़ी प्रतिक्रिया अपेक्षाओं के साथ तेज़ रिव्यू | छोटे फीडबैक चक्र; लेखक के लिए कम संदर्भ-हानि; कम प्रगतिरत कार्य | जल्दी स्वीकृत करने का दबाव; केंद्रित काम में बाधा |
| धीमी, गहन रिव्यू | रचना और जोखिम का सावधान पाठ; मज़बूत ज्ञान-हस्तांतरण | लंबा साइकल टाइम; बड़े बैच जमा होते हैं; लेखक आगे बढ़ जाते हैं और संदर्भ खो देते हैं |
| छोटी पुल रिक्वेस्टें | पढ़ना और वापस करना आसान; सहज प्रवाह | प्रति बदलाव अधिक ओवरहेड; फ़ीचर को भ्रमित करने वाले चरणों में बाँट सकती हैं |
| बड़ी पुल रिक्वेस्टें | कम हस्तांतरण; पूरी फ़ीचर एक साथ दिखती है | रिव्यू उथली हो जाती हैं; वापस करना कठिन; लंबी प्रतीक्षा |
| नामित स्वामी से अनिवार्य अनुमोदन | जोखिम भरे क्षेत्रों के लिए स्पष्ट जवाबदेही; परिवर्तन प्राधिकरण को सहारा | बाधा और विफलता का एकल बिंदु बनाता है |
| मानवीय रिव्यू से पहले स्वचालित जाँचें | लोगों को रचना और जोखिम के लिए मुक्त करती हैं; एकसमान | झूठा आत्मविश्वास दे सकती हैं; रख-रखाव चाहिए |
कोई एक नीति नहीं जीतती। उद्देश्य जाँच बनाए रखते हुए प्रतीक्षा छोटी करना है, और सामान्य रास्ता छोटे बदलाव, स्पष्ट रिव्यू अपेक्षाएँ, नियमित जाँचों के लिए मज़बूत स्वचालन, और इस पर टीम का समझौता है कि अच्छी रिव्यू कैसी दिखती है। रिव्यू मीट्रिक्स रेट्रोस्पेक्टिव के प्रश्नों के रूप में सबसे उपयोगी हैं और लक्ष्यों के रूप में सबसे कम।
अपनी टीम के साथ चर्चा के प्रश्न
1. पुल रिक्वेस्ट अपने जीवन का अधिकांश कहाँ बिताती है, प्रतीक्षा में या समीक्षा में? टीम से डेटा देखने से पहले अनुमान लगाने को कहें, फिर पहली समीक्षा के समय और मर्ज तक के बाकी समय का विभाजन दिखाएँ। अधिकांश समूह इससे चौंकते हैं कि कितना प्रतीक्षा है। सूत्रधार दर्ज करे कि कौन-से अनुमान ग़लत थे और पूछे कि हर ग़लत अनुमान इस बारे में क्या कहता है कि टीम रिव्यू को कैसे अनुभव करती है। एक बदलाव पर समाप्त करें जो सबसे बड़ी प्रतीक्षा पर प्रहार करे।
2. इस टीम में अच्छी रिव्यू कैसी दिखती है, और बाहर वाला कैसे बताएगा? वे व्यवहार सूचीबद्ध करें जिनकी टीम कद्र करती है, जैसे रचना के बारे में पूछना, परीक्षण जाँचना, और अनुरोध का कारण समझाना। फिर पूछें कि उनमें से कौन-से पुल रिक्वेस्ट में दिखाई देने वाला निशान छोड़ते हैं। चर्चा करें कि व्यक्तियों पर पहरा दिए बिना सारगर्भित पहली प्रतिक्रिया को औपचारिक से कैसे अलग बताएँ। कार्य-समझौते में रखने के लिए छोटे लिखित वर्णन पर सहमत हों।
3. हमारे लिए कितना बड़ा बहुत बड़ा है, और जब काम सचमुच बड़ा हो तो हम क्या करते हैं? आकार का वितरण देखें और कुछ सबसे बड़ी पुल रिक्वेस्टें चुनें। पूछें कि हर एक बड़ी क्यों थी और क्या उसे काटा जा सकता था। फ़ीचर टॉगल, तैयारी की रीफ़ैक्टरिंग और झंडे के पीछे मर्ज करने जैसी तकनीकों पर चर्चा करें। सूत्रधार संख्यात्मक सीमा तय करने का विरोध करे और इसके बजाय ऐसी आदत पर सहमत हो जिसे टीम एक महीना आज़माएगी।
4. हमारे सबसे जोखिम भरे कोड की रिव्यू कौन करता है, और जब वे दूर हों तो क्या होता है? कोड के क्षेत्रों को उन लोगों से मैप करें जो उनकी अच्छी रिव्यू कर सकते हैं। भार का संकेंद्रण और ऐसे क्षेत्र देखें जिनका एक ही योग्य समीक्षक है। चर्चा करें कि हर एक में दूसरा समीक्षक कैसे तैयार हो, जोड़ी बनाकर या काम घुमाकर। बातचीत टीम के लचीलेपन के बारे में रखें, किसी के कार्यभार की रैंकिंग के बारे में नहीं।
5. यदि कल हमारी रिव्यू की गति दोगुनी हो जाए, तो हम गुणवत्ता के बारे में क्या सच चाहेंगे? समूह से वे गुणवत्ता-संकेत नामित करने को कहें जिन पर वे नज़र रखेंगे, जैसे मर्ज के बाद के सुधार, हाल के बदलावों से जुड़ी घटनाएँ, या रिवर्टों की संख्या। जाँचें कि क्या वे संकेत अभी गति के चार्ट के बगल में दिखाई देते हैं। चर्चा करें कि इसका शुरुआती संकेत क्या होगा कि गति जाँच की कीमत पर खरीदी गई। तय करें कि डैशबोर्ड पर कौन-सा साथी दिखाया जाएगा।
6. रिव्यू की कौन-सी संख्याओं को हम ऐसे तरीके से सुधारने के लिए ललचाएँगे जो मदद नहीं करता? हर माप पर चलें और पूछें कि दबाव में कोई व्यक्ति उसे कुछ बेहतर किए बिना बेहतर कैसे दिखा सकता है। उत्तरों की तुलना ऊपर की गेमिंग तालिका से करें और टीम के अपने विचार जोड़ें। उद्देश्य जोखिम को होने से पहले नाम देना है। तय करें कि हर माप के साथ कौन-सी सुरक्षा-रेखा की समीक्षा होगी।
चार दृष्टिकोण
उत्पाद और डिलीवरी टीमें
डिलीवरी टीमें रिव्यू प्रक्रिया की स्वामी हैं और उन्हें उसकी मीट्रिक्स की भी स्वामी होना चाहिए। उन्हें सरल समझौतों से प्रतीक्षा घटाने में सबसे अधिक लाभ होता है: दैनिक रिव्यू स्लॉट, स्पष्ट अनुरोध प्रक्रिया और छोटे बदलाव। उन्हें रेट्रोस्पेक्टिव में संख्याओं का उपयोग करना चाहिए, प्रगतिरत कार्य कम रखना चाहिए, और किसी एक चार्ट को अनुकूलित करने के लोभ का विरोध करना चाहिए। रिव्यू वह जगह भी है जहाँ नए सदस्य कोडबेस सीखते हैं, इसलिए उस उद्देश्य की रक्षा करें।
सेवा और संचालन टीमें
संचालन टीमें रिव्यू से तब मिलती हैं जब इंफ्रास्ट्रक्चर कोड, कॉन्फ़िगरेशन और रनबुक स्वचालन पुल रिक्वेस्ट से बदले जाते हैं। उनके लिए रिव्यू अक्सर इसका हिस्सा है कि मानक परिवर्तन कैसे स्वीकृत और प्रमाणित होता है (देखें विषय 4.3, परिवर्तन सक्षमीकरण मीट्रिक्स)। उन्हें तय करना चाहिए कि किन बदलावों को दूसरे व्यक्ति की रिव्यू चाहिए, तत्काल सुधारों की कितनी जल्दी रिव्यू होती है, और आपातकालीन बदलावों की बाद में रिव्यू कैसे होती है, ताकि हड़बड़ी का सुधार भी जाँचा जाए। जोखिम भरे बदलाव पर हल्की रिव्यू बाद में घटना के रूप में दिखती है।
नेतृत्व और शासन
नेताओं को रिव्यू मीट्रिक्स को टीम के स्वास्थ्य और प्रवाह के संकेत मानना चाहिए, उत्पादकता अंक नहीं। जब भी गति की संख्या रिपोर्ट हो, वे साथी गुणवत्ता-माप माँगें, सावधान रिव्यू में लगने वाले समय का समर्थन करें, और कच्चे रिव्यू समय पर टीमों की तुलना से बचें, क्योंकि रिपॉज़िटरियाँ और जोखिम भिन्न हैं। शासन निकाय रिव्यू के प्रमाण को परिवर्तन आश्वासन का हिस्सा बना सकते हैं, बशर्ते वे मानें कि दर्ज, नमूना-जाँची गई रिव्यू प्रक्रिया अनुमोदनों की गिनती से अधिक मज़बूत है।
ग्राहक और उपयोगकर्ता
ग्राहक पुल रिक्वेस्ट नहीं देखते, फिर भी परिणाम महसूस करते हैं: सुधार कितनी जल्दी आता है और कितनी बार रिलीज़ नया दोष लाती है। छोटी रिव्यू प्रतीक्षाएँ तत्काल सुधारों को उन तक जल्दी पहुँचाती हैं, और विचारशील रिव्यू गड़बड़ियों को उनसे दूर रखने में मदद करती है। जहाँ सेवा का प्रकाशित रिलीज़ या दोष इतिहास है, वहाँ ग्राहकों को लाभ होता है जब टीम समय के साथ कम वापसियाँ और कम बार-बार के सुधार दिखाती है।
व्यवहार में: सेवा प्रबंधन का एक उदाहरण
एक क्षेत्रीय अस्पताल का IT विभाग मरीज़-अपॉइंटमेंट वेब सेवा चलाता है, जिसे सात लोगों की एक उत्पाद टीम ने बनाया और छोटे साइट विश्वसनीयता समूह के साथ संचालित किया जाता है। इस उदाहरण की सभी संख्याएँ दृष्टांत के लिए हैं।
तिमाही समीक्षा में टीम पाती है कि उसका रिव्यू साइकल टाइम माध्य 26 कार्य-घंटे और 85वाँ परसेंटाइल 71 कार्य-घंटे है (दृष्टांत)। चक्र को बाँटने पर पहली समीक्षा का माध्य समय 19 कार्य-घंटे है, इसलिए अधिकांश देरी प्रतीक्षा है। पुल रिक्वेस्ट का आकार माध्य 180 पंक्तियाँ और 85वाँ परसेंटाइल 900 पंक्तियाँ है (दृष्टांत), और दो सबसे व्यस्त समीक्षक 68 प्रतिशत रिव्यू संभालते हैं (दृष्टांत)। मर्ज के बाद सुधार की दर 9 प्रतिशत पर है (दृष्टांत)।
टीम तीन समझौते करती है। वे दैनिक 30 मिनट का रिव्यू स्लॉट तय करते हैं, एक कार्यदिवस के भीतर पहली प्रतिक्रिया की अपेक्षा अपने कार्य-समझौते में लिखते हैं, और हर सप्ताह "पहले रिव्यू" की ड्यूटी घुमाते हैं। वे बड़े काम के लिए काटने की आदत भी अपनाते हैं, फ़ीचर टॉगल का उपयोग करके ताकि आंशिक फ़ीचर सुरक्षित रूप से मर्ज हो सकें। वे आकार की सीमा या पहली समीक्षा के समय का लक्ष्य नहीं रखते।
दो महीने बाद माध्य पहली समीक्षा का समय 6 कार्य-घंटे पर और रिव्यू साइकल टाइम का 85वाँ परसेंटाइल 34 कार्य-घंटे पर आ जाता है (दृष्टांत)। भार का संकेंद्रण 52 प्रतिशत पर आ जाता है (दृष्टांत), और मर्ज के बाद सुधार की दर 9 प्रतिशत पर बनी रहती है।
फिर टीम गेमिंग का जोखिम पकड़ती है। अनुमोदनों का नमूना दिखाता है कि अपॉइंटमेंट-रिमाइंडर के तर्क को छूने वाले बदलावों पर लगभग एक-तिहाई पहली प्रतिक्रियाएँ मिनटों में आती हैं और केवल "LGTM" पढ़ती हैं। गति का लाभ आंशिक रूप से असली था और आंशिक रूप से रबर स्टैम्प। मर्ज के बाद सुधार की दर अभी नहीं हिली थी क्योंकि प्रभावित कोड मासिक चक्र पर चलता है। टीम कार्य-समझौता बदलती है ताकि पहली प्रतिक्रिया में या तो प्रश्न हो, बदलाव के किसी विशिष्ट हिस्से पर टिप्पणी हो, या स्पष्ट नोट हो कि क्या जाँचा गया, और बिना-टिप्पणी अनुमोदनों का नमूना हिस्सा अपने रिव्यू चार्ट में जोड़ती है। वे यह भी सहमत होते हैं कि मरीज़-मुखी रिमाइंडर तर्क में बदलावों को दो समीक्षक चाहिए, जिनमें से एक संचालन समूह का हो। कारणों सहित निर्णय टीम के निर्णय लॉग में जाता है।
एजाइल, AI, स्वचालन और विश्लेषण
एजाइल
तेज़, छोटी रिव्यू निरंतर डिलीवरी और टिकाऊ गति को सहारा देती हैं। व्यावहारिक आदत है पहली समीक्षा के समय के लिए टीम की मर्यादा तय करना और नियमित टीम समीक्षा में बासी पुल रिक्वेस्टों पर बात करना। सावधानी यह है कि लक्ष्य की तरह बरती गई रिव्यू की गति रबर-स्टैम्पिंग की ओर ले जाती है, इसलिए उसे मर्ज के बाद के सुधारों से जोड़ें।
AI
AI-जनित बदलाव पुल रिक्वेस्ट की मात्रा और आकार बढ़ा सकते हैं, और AI रिव्यू औज़ार पहली नज़र तेज़ कर सकते हैं। AI-सहायता वाले बदलावों के लिए पहली समीक्षा के समय को मर्ज के बाद सुधार की दर से जोड़ें, और रिव्यू का भार प्रति व्यक्ति नहीं, प्रति समीक्षक-भूमिका रिपोर्ट करें। सावधानी यह है कि बॉट की रिव्यू टिप्पणी रिव्यू गिनी जा सकती है, इसलिए मानवीय रिव्यू अलग गिनें।
स्वचालन
कोड होस्ट से रिव्यू की घटनाएँ अपने-आप खींचें, और मानवीय रिव्यू से पहले स्वचालित जाँचें चलाएँ ताकि लोग विवेक पर समय लगाएँ। जाँचों को स्वयं झूठे अलार्मों और उनसे बच निकले दोषों पर मापें। सावधानी यह है कि भारी स्वचालन मानवीय रिव्यू को सतही बना सकता है, क्योंकि लोग मान लेते हैं कि औज़ारों ने सब पकड़ लिया।
विश्लेषण
आकार, पहली समीक्षा के समय और रिव्यू के दौर के वितरण टीम के अनुसार दिखाएँ, व्यक्ति के अनुसार कभी नहीं। यह जिस निर्णय को सूचित करता है वह है कि रिव्यू की क्षमता या बदलाव के आकार पर कहाँ ध्यान चाहिए। सावधानी यह है कि ये संख्याएँ रिव्यू प्रणाली का वर्णन करती हैं, और लोगों की रैंकिंग करने वाला कोई भी उपयोग उन्हें छोटे, सुरक्षित, कम उपयोगी बदलावों की ओर धकेलेगा।
क्षेत्र का नज़रिया
स्टार्टअप। छोटी टीम मिनटों में रिव्यू कर सकती है क्योंकि सब कोड जानते हैं, और मुख्य जोखिम समय कम होने पर रिव्यू छोड़ना है। मीट्रिक्स कम रखें: पहली समीक्षा का समय और आकार काफ़ी हैं। छोटे बदलावों की आदत जल्दी डालें, क्योंकि कोडबेस और टीम के बढ़ने के बाद उसे लाना कहीं कठिन है।
छोटा व्यवसाय। अक्सर एक या दो डेवलपर, या बाहरी आपूर्तिकर्ता, सॉफ़्टवेयर अनुरक्षित करते हैं। रिव्यू एक सहकर्मी या आपूर्तिकर्ता के अपने स्टाफ़ द्वारा हो सकती है। आपूर्तिकर्ताओं से पूछें कि वे रिव्यू कैसे करते हैं और क्या पुल रिक्वेस्ट का डेटा साझा हो सकता है, और सरल रिकॉर्ड रखें कि किन बदलावों की रिव्यू किसने की, क्योंकि छोटी टीम में ग़लतियों के विरुद्ध मुख्य जाँच रिव्यू ही है।
उद्यम। कई टीमें, रिपॉज़िटरियाँ और अनुमोदन नियम व्यापक विविधता पैदा करते हैं। घड़ियों और अपवर्जनों की परिभाषाएँ मानकीकृत करें ताकि प्लैटफ़ॉर्म का डेटा तुलनीय हो, पर टीमों की रैंकिंग कच्चे रिव्यू समय पर न करें, क्योंकि जोखिम और कोडबेस अलग हैं। ऑडिट के लिए थोपी गई रिव्यू आवश्यकताओं से सावधान रहें जो जाँच जोड़े बिना प्रतीक्षा जोड़ती हैं, और हस्तचालित अनुमोदनों की जगह स्वचालित जाँचों और नमूना रिव्यू के अवसर खोजें।
सरकार और सार्वजनिक क्षेत्र। कर्तव्यों का पृथक्करण, ऑडिट ट्रेल और खरीद के नियम अक्सर बदलावों के लिए स्वतंत्र अनुमोदन की माँग करते हैं। उन नियमों को रचना के इनपुट मानें: दर्ज करें कि किसने क्या कब स्वीकृत किया, और उनसे बनी प्रतीक्षा मापें। जहाँ आपूर्तिकर्ता कोड लिखते हैं, वहाँ अनुबंध में रिव्यू के प्रमाण और डेटा की पहुँच निर्दिष्ट करें (देखें विषय 8.5, विनियमित और सरकारी रिपोर्टिंग)।
व्यावसायिक औचित्य: प्रेरणाएँ, ROI और TCO
प्रेरणा डिलीवरी के उस हिस्से को छोटा करना है जो धीमा भी है और नियंत्रणीय भी, जबकि सहकर्मी रिव्यू के लाभ बनाए रखना: कम दोष, साझा ज्ञान और ऑडिट ट्रेल। प्रतीक्षा करती पुल रिक्वेस्टें पूरे हुए काम को उपयोगकर्ताओं तक पहुँचने से रोकती हैं, लेखकों के लिए संदर्भ-परिवर्तन की लागत बढ़ाती हैं, और शाखाओं के पुराने होने पर मर्ज के टकराव की संभावना बढ़ाती हैं। इसलिए प्रतीक्षा घटाना तेज़ डिलीवरी, कम पुनर्कार्य और कम निराशा के रूप में फल देता है।
जब संस्करण नियंत्रण प्लैटफ़ॉर्म घटना इतिहास और API देता है तो इन मीट्रिक्स को जुटाने की लागत कम है। मुख्य लागतें घड़ियों और अपवर्जनों को परिभाषित करने, रिपोर्ट बनाने या कॉन्फ़िगर करने, और संख्याओं की नियमित समीक्षा करने का समय है। बड़ी लागत व्यवहारिक है: प्रतिक्रियाशील रिव्यू के लिए लोगों का दिया समय, जो अन्य काम से प्रतिस्पर्धा करता है। वह समय असली निवेश है, और उसे मुफ़्त मानने के बजाय बजट में रखा जाना चाहिए।
प्रतिफल छोटे रिव्यू साइकल टाइम, कम बासी पुल रिक्वेस्टों, और स्थिर या घटती मर्ज के बाद सुधार की दर के रूप में दिखता है। पहले से किसी विशेष प्रतिशत सुधार का दावा न करें, क्योंकि परिणाम शुरुआती बिंदु और टीम पर निर्भर हैं। विश्वसनीय औचित्य अन्य संगठनों के आँकड़े उद्धृत करने की जगह टीम के अपने पहले और बाद के वितरणों की तुलना उसके गुणवत्ता-साथी के साथ करता है। 2018 की पुस्तक Accelerate तकनीकी और सांस्कृतिक प्रैक्टिसों को डिलीवरी प्रदर्शन से जोड़ने वाले शोध की रिपोर्ट करती है और सामान्य तर्क के लिए उचित स्रोत है, पर आपकी टीम की संख्याएँ आपके अपने डेटा से आती हैं।
प्रतिरूप-विरोधी और जाल
- समीक्षकों या लेखकों की रैंकिंग। पूरी की गई रिव्यू या बदली पंक्तियों के व्यक्तिगत लीडरबोर्ड सहयोग को भ्रष्ट करते हैं। टीम के स्तर पर रिपोर्ट करें और संख्याओं का उपयोग टीम की आदतें समायोजित करने के लिए करें।
- गुणवत्ता के साथी के बिना पहली समीक्षा के समय का लक्ष्य। नतीजा रबर स्टैम्प है। हर गति चार्ट के बगल में मर्ज के बाद सुधार की दर और बिना-टिप्पणी अनुमोदनों का नमूना दिखाएँ।
- कठोर आकार-सीमा तय करना। टीमें पालन के लिए कृत्रिम रूप से काम बाँटती हैं। आकार का उपयोग बातचीत के रूप में करें और इसके बजाय काटने की तकनीकें सिखाएँ।
- शून्य टिप्पणियों को सफलता मानना। बिना जाँचा अनुमोदन भरोसे या असावधानी का संकेत हो सकता है। ऐसी पुल रिक्वेस्टों का नमूना लें और साथ पढ़ें।
- बॉट की गतिविधि को रिव्यू गिनना। स्वचालित टिप्पणियाँ प्रतीक्षा को छोटा दिखाती हैं। बॉट को घड़ी से और भार के मापों से बाहर रखें।
- समय-क्षेत्रों और कैलेंडरों की अनदेखी। कच्चा घड़ी-समय सप्ताहांत और क्षेत्र-पार प्रतीक्षा को धीमी रिव्यू जैसा दिखाता है। कार्य-घंटों का उपयोग करें और कैलेंडर का नाम बताएँ।
- बासी सूची को बढ़ने देना। पुरानी पुल रिक्वेस्टें मर्ज के टकराव जमा करती हैं और संदर्भ खो देती हैं। सूची की साप्ताहिक समीक्षा करें और हर मद को मर्ज करें, फिर से काम करें, या कारण सहित बंद करें।
परिपक्वता मॉडल
| आयाम | 1 आरंभ | 2 विकास | 3 मानकीकरण | 4 प्रबंधन | 5 समन्वयन |
|---|---|---|---|---|---|
| परिभाषा और घड़ियाँ | रिव्यू का समय अंदाज़े से या अनुभव से बताया जाता है | कुछ टीमें अपने नियमों से प्लैटफ़ॉर्म से समय निर्यात करती हैं | बॉट, ड्राफ़्ट और कैलेंडरों के अपवर्जनों सहित हर घड़ी की एक लिखित परिभाषा | परिभाषाओं की लय पर समीक्षा; बदलाव कारण सहित लॉग | परिभाषाएँ टीमों और आपूर्तिकर्ताओं में संरेखित और निर्णयों को सूचित करना बंद करने पर संशोधित |
| रिव्यू का अभ्यास | रिव्यू तब होती हैं जब कोई ध्यान देता है | कुछ टीमों में अनौपचारिक मानदंड | अनुरोधों, प्रतिक्रिया की अपेक्षाओं और रिव्यू क्या कवर करती है इस पर लिखित कार्य-समझौता | डेटा से मानदंड समायोजित; ज्ञान-साझाकरण और जोखिम वाले क्षेत्र ट्रैक | रिव्यू का अभ्यास टीमों और आपूर्तिकर्ताओं में समन्वित, नियमित जाँचें स्वचालन के हाथ |
| गुणवत्ता का साथी | रिव्यू और दोषों के बीच कोई कड़ी नहीं | कभी-कभार मर्ज के बाद सुधारों पर नज़र | मर्ज के बाद सुधार की दर रिव्यू की गति के बगल में दिखती है | सुरक्षा-रेखाओं की नियमित समीक्षा; नमूना अनुमोदन पढ़े जाते हैं | रिव्यू का प्रमाण सेवाओं के पार परिवर्तन आश्वासन और घटना से सीख से जुड़ा |
| सुधार में उपयोग | संख्याएँ अप्रयुक्त | कुछ रेट्रोस्पेक्टिव में दिखाई जाती हैं | स्वामी टीम द्वारा निश्चित लय पर समीक्षित | अंतर नियोजित, संसाधन-युक्त सुधार-कार्य तक ले जाते हैं | सुधार के विचार टीमों से साझा अभ्यास तक और वापस बहते हैं |
जाँच-सूची
- पहली समीक्षा के समय और रिव्यू साइकल टाइम की घड़ियाँ आरंभ, अंत और अपवर्जनों सहित लिखी गई हैं।
- बॉट, ड्राफ़्ट और बिना मर्ज बंद पुल रिक्वेस्टें बाहर हैं या अलग गिनी गई हैं, और नियम दिखाई देते हैं।
- समय कार्य-घंटों में माध्य और ऊँचे परसेंटाइल के रूप में रिपोर्ट होते हैं।
- पुल रिक्वेस्ट का आकार जनित और वेंडर किए फ़ाइलों की सहमत ignore सूची के साथ मापा जाता है।
- टीम के पास लिखित समझौता है कि रिव्यू कैसे माँगी जाती हैं और पहली प्रतिक्रिया कितनी जल्दी अपेक्षित है।
- रिव्यू भार का संकेंद्रण केवल टीम-स्तर पर रिपोर्ट होता है।
- मर्ज के बाद सुधार की दर या अन्य गुणवत्ता-साथी रिव्यू की गति के साथ उसी चार्ट पर दिखाया जाता है।
- बिना-टिप्पणी और बहुत तेज़ अनुमोदनों का नमूना हर महीने पढ़ा जाता है।
- बासी पुल रिक्वेस्ट सूची की साप्ताहिक समीक्षा होती है।
- रिव्यू का डेटा रेट्रोस्पेक्टिव में उपयोग होता है, व्यक्तिगत मूल्यांकन में नहीं।
- कोड के जिन क्षेत्रों का एक ही योग्य समीक्षक है उन्हें सूचीबद्ध किया गया है और उनकी योजना है।
AI प्रॉम्प्ट
रिव्यू मीट्रिक्स के लिए घड़ी की परिभाषाओं का मसौदा बनाएँ।
I want to define review metrics for [team or repository]. Our platform is
[version control platform] and our workflow is [describe: draft pull requests,
required approvals, merge rules, bots in use]. Draft precise definitions for time
to first review and review cycle time, stating the event that starts and stops
each clock, what is excluded (bots, drafts, closed unmerged), how working hours
are handled for [time zones and working calendar], and which percentiles to
report. Do not invent benchmark values or tool features. List your assumptions and
the questions I should answer to finish the definitions.
रिव्यू के डेटा निर्यात का विश्लेषण करें।
Here is an anonymized export of merged pull requests for [team] over [period],
with columns [list columns, for example ready time, first review time, merge time,
lines changed, review rounds, linked fix flag]: [paste data or summary]. Compute
the median and 85th percentile for each time measure and for size, split the
review cycle into waiting and reviewing, and point out patterns that deserve a
conversation. Do not rank individuals, and do not compare with outside
benchmarks. List your assumptions and any data quality problems you notice.
हमारी रिव्यू मीट्रिक्स में गेमिंग के जोखिम खोजें।
Our team reports these review metrics: [list metrics and how each is calculated].
The pressures on us are [for example a release deadline, a leadership target, a
supplier contract]. For each metric, describe plausible ways it could be improved
without improving review, the early signs of each, and a paired guardrail metric
or practice that would catch it. Do not invent statistics. List your assumptions
and tell me what you would need to know to rank the risks.
रिव्यू के प्रवाह पर रेट्रोस्पेक्टिव तैयार करें।
Prepare a 45-minute retrospective agenda for [team] on review flow. Inputs: time
to first review [value], review cycle time [value], median size [value], load
concentration [value], and post-merge fix rate [value], all labeled with their
definitions. Suggest questions that surface causes, one small experiment the team
could run for [duration], and the quality signal to watch during the experiment.
Do not invent causes or targets. List your assumptions and the data I should bring.
AI स्किल
- Service Management Metrics skill: संबंधित प्रवाह या गुणवत्ता मीट्रिक को परिभाषित करने वाला विषय और रिव्यू मीट्रिक के बगल में रहने वाली सुरक्षा-रेखा खोजने के लिए उपयोग करें।
- Service Management Metrics maintainer skill: यह जाँचने के लिए उपयोग करें कि इस विषय के संपादन टेम्पलेट, गेमिंग तालिका और अंतर-संदर्भों को संगत रखते हैं।
मुख्य निष्कर्ष
- रिव्यू की अधिकांश देरी प्रतीक्षा है, इसलिए पहली समीक्षा का समय और रिव्यू साइकल टाइम कार्य-घंटों में वितरण के रूप में मापें।
- छोटी पुल रिक्वेस्टों की रिव्यू तेज़ और अधिक सावधानी से होती है; आकार की सीमा थोपने की जगह काटना सिखाएँ।
- हर गति-माप को मर्ज के बाद सुधार की दर जैसे गुणवत्ता-साथी से जोड़ें, और दोनों साथ पढ़ें।
- रिव्यू के भार को टीम की क्षमता मानें और संकेंद्रण टीम-स्तर पर रिपोर्ट करें, लोगों की रैंकिंग के रूप में कभी नहीं।
- रिव्यू मीट्रिक्स रेट्रोस्पेक्टिव के लिए प्रश्न हैं, और वे उस टीम की सेवा करती हैं जो काम की स्वामी है।
संदर्भ और आगे का अध्ययन
- Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
- Forsgren, N., Storey, M.-A., Maddila, C., Zimmermann, T., Houck, B., and Butler, J., "The SPACE of Developer Productivity," ACM Queue, 2021.
- Google, Code Review Developer Guide, Google Engineering Practices documentation, https://google.github.io/eng-practices/review/
- Bacchelli, A., and Bird, C., "Expectations, Outcomes, and Challenges of Modern Code Review," Proceedings of the 35th International Conference on Software Engineering (ICSE), 2013.
- Vacanti, D. S., Actionable Agile Metrics for Predictability: An Introduction, Daniel S. Vacanti, Inc., 2015.
- Schwaber, K., and Sutherland, J., The Scrum Guide, Scrum.org and Scrum Inc., 2020.
- Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
- Wikipedia, Pull request.
- Wikipedia, Version control.
- Wikipedia, Code review.
- Wikipedia, Goodhart's law.
- Wikipedia, Continuous integration.
- Wikipedia, Trunk-based development.
- Wikipedia, Pair programming.
- Wikipedia, Static program analysis.