पुल रिक्वेस्ट और कोड रिव्यू मेट्रिक्स
समीक्षा वह जगह है जहाँ पूरा हुआ काम सबसे अधिक इंतज़ार करता है, इसलिए मापें कि बदलाव किसी के देखने से पहले कितनी देर पड़ा रहता है, वह कितना बड़ा है, और कितनी बार लौटता है, और हर गति संख्या को गुणवत्ता संकेत से जोड़ें ताकि तेज़ का मतलब लापरवाह कभी न हो।
सारांश और प्रेरणा
पुल रिक्वेस्ट संस्करण नियंत्रण रिपॉज़िटरी की एक ब्रांच से दूसरी में बदलावों का समूह मर्ज करने का प्रस्ताव है, साथ में इस बारे में बातचीत कि उसे मर्ज होना चाहिए या नहीं। कई टीमों में यह "लेखक सोचता है कि यह काम करता है" और "टीम सहमत है कि यह शिप हो सकता है" के बीच औपचारिक द्वार है। बातचीत कोड रिव्यू का रूप है: लेखक के अलावा कोई व्यक्ति बदलाव पढ़ता है, प्रश्न पूछता है, और उसे स्वीकृत करता है या संशोधन माँगता है। कुछ प्लेटफ़ॉर्म उसी चीज़ को मर्ज रिक्वेस्ट कहते हैं; यह विषय दोनों के लिए "पुल रिक्वेस्ट" का उपयोग करता है।
समीक्षा मापने लायक है, एक सादे कारण से। डिलीवरी के प्रवाह दृश्य में, कार्य मद अपने जीवन का अधिकांश इंतज़ार में बिताती है, और समीक्षा उन प्रतीक्षाओं में से है जो पूरी तरह टीम के नियंत्रण के भीतर बैठती है। साझा प्लेटफ़ॉर्म की बाधा या बाहरी निर्भरता के लिए दूसरे लोगों को बदलना पड़ता है। जो पुल रिक्वेस्ट पहली नज़र के लिए दो दिन इंतज़ार करती है उसके लिए केवल टीम की अपनी आदतों को बदलना पड़ता है। इस पुस्तक के प्रवाह माप (देखें विषय 2.1, प्रवाह माप, और विषय 2.2, लीड टाइम, साइकल टाइम और प्रवाह दक्षता) सामान्य शब्दावली देते हैं। यह विषय चक्र के एक चरण पर ज़ूम करता है और उसे अपने उपकरण देता है।
एजाइल और ITIL के दृष्टिकोण यहाँ उपयोगी ढंग से मिलते हैं। एजाइल दृष्टि से, समीक्षा प्रतिक्रिया का चक्र और सिखाने की क्रियाविधि है। यह कोडबेस का ज्ञान फैलाती है, खामियाँ जल्दी पकड़ती है, और टीम के कार्य समझौते और पूर्णता की परिभाषा लागू करती है। ITIL दृष्टि से, वही गतिविधि कई अभ्यासों का समर्थन करती है। ITIL 4 में, सॉफ़्टवेयर विकास और प्रबंधन अभ्यास कवर करता है कि सॉफ़्टवेयर कैसे बनाया और जाँचा जाता है, परिवर्तन सक्षमीकरण कवर करता है कि बदलावों का मूल्यांकन और अधिकृत कैसे होता है, और तैनाती प्रबंधन कवर करता है कि बदलाव जीवित परिवेश तक कैसे पहुँचते हैं। सहकर्मी-समीक्षित पुल रिक्वेस्ट कई संगठनों के लिए इसका प्रमाण है कि मानक बदलाव का रिलीज़ से पहले मूल्यांकन हुआ। समीक्षा को मापी हुई, सुधार योग्य गतिविधि मानना दोनों दृष्टियों की सेवा करता है: एजाइल टीम तेज़ प्रतिक्रिया चाहती है, और ITIL अभ्यास आश्वासन चाहता है कि बदलावों की जाँच हुई।
जिस जोखिम को पूरे समय नज़र में रखना है वह यह है कि समीक्षा की गति और समीक्षा की गुणवत्ता को अलग करना आसान है। टीम पहली समीक्षा का समय आधा कर सकती है सब कुछ देखते ही स्वीकृत करके, और डैशबोर्ड जीत दिखाएगा जबकि कोडबेस बिगड़ता है। गुडहार्ट का नियम इस मेट्रिक परिवार पर असामान्य बल से लागू होता है (देखें विषय 1.2, गुडहार्ट का नियम और मेट्रिक्स का मनोविज्ञान), क्योंकि संख्याएँ इकट्ठा करने में सस्ती, सबको दिखने वाली, और उस चीज़ को बदले बिना हिलाने में बहुत आसान हैं जिसका वे प्रतिनिधित्व करने वाली थीं। नीचे की हर सिफ़ारिश इसी को ध्यान में रखकर लिखी गई है।
लेखक ने पुल रिक्वेस्ट खोली और समीक्षक उसका आकलन करता है। समीक्षा चक्र "लेखक पुश करता है, समीक्षक उत्तर देता है" का एक लूप है। पुनर्कार्य समीक्षा टिप्पणी के बाद, या मर्ज के बाद, पहले संस्करण की किसी गलती को ठीक करने के लिए किया गया बदलाव है। सतत एकीकरण (CI) साझा रेखा में अक्सर काम मर्ज करने और हर मर्ज की स्वचालित जाँच करने का अभ्यास है; देखें सतत एकीकरण।
इस विषय की सभी मेट्रिक्स टीमों और रिपॉज़िटरियों का वर्णन करती हैं। वे समीक्षकों या लेखकों को कभी रैंक नहीं करतीं। व्यक्ति-स्तर की समीक्षा गिनतियाँ निकालना आसान और उपयोग के लिए ललचाने वाला है, और ऐसा करना सहयोग के अभ्यास को प्रतियोगिता में बदल देता है (देखें विषय 9.1, टीम स्वास्थ्य और डेवलपर अनुभव)।
मुख्य सिद्धांत
- प्रतीक्षा समीक्षा पर हावी है। अधिकांश टीमों में समीक्षा समय का सबसे बड़ा हिस्सा पुल रिक्वेस्ट के बिना पढ़े पड़े रहने का है, समीक्षक के शुरू करने के बाद की चर्चा का नहीं। बातचीत मापने से पहले प्रतीक्षा मापें।
- छोटे बदलावों की समीक्षा तेज़ और बेहतर होती है। आकार उन गिने-चुने लीवरों में से है जो गति और गहनता दोनों को साथ सुधारते हैं, क्योंकि समीक्षक छोटे बदलाव को दिमाग में रख सकता है।
- जाँच के बिना गति सुधार नहीं है। इस विषय की हर गति मेट्रिक को गुणवत्ता समकक्ष चाहिए, और जोड़ी साथ पढ़ी जाती है।
- समीक्षा टीम की क्षमता है, व्यक्तिगत नहीं। भार टीम में फैलना चाहिए। जो मेट्रिक संकेंद्रण दिखाती है वह टीम के डिज़ाइन की समस्या की ओर इशारा करती है, कभी किसी व्यक्ति की ओर नहीं जिसकी प्रशंसा या दोष हो।
- वितरण औसत से बेहतर हैं। समीक्षा समयों में अटकी पुल रिक्वेस्ट की लंबी पूँछ होती है, इसलिए माध्यिका और ऊँचा पर्सेंटाइल रिपोर्ट करें (देखें विषय 1.6, सेवा मेट्रिक्स के लिए सांख्यिकीय साक्षरता)।
- घड़ी परिभाषित करें, फिर उसे अकेला छोड़ दें। बताएँ कि घड़ी कब शुरू और बंद होती है, कौन-सी घटनाएँ उसे ठहराती हैं, और कौन-सी स्वचालित गतिविधि बाहर है, और इसे वहाँ लिखें जहाँ डेटा रहता है (देखें विषय 1.5, डेटा स्रोत और इंस्ट्रूमेंटेशन)।
- समीक्षा मेट्रिक्स उस टीम की सेवा करती हैं जो काम की स्वामी है। वे टीम के अपने रेट्रोस्पेक्टिव का इनपुट हैं, किसी और के लिए स्कोरकार्ड नहीं।
मेट्रिक परिभाषाएँ
नीचे की घड़ियाँ मानती हैं कि संस्करण नियंत्रण प्लेटफ़ॉर्म खोलने, समीक्षा अनुरोध, टिप्पणियों, अनुमोदनों, पुश और मर्ज के घटना-समय दर्ज करता है। ड्राफ़्ट, बॉट द्वारा खोली गई पुल रिक्वेस्ट, और बिना मर्ज के बंद की गई पुल रिक्वेस्ट बाहर हैं जब तक कोई पंक्ति अन्यथा न कहे। "कार्य घंटे" का अर्थ टीम के घोषित कार्य घंटे हैं, ताकि शुक्रवार शाम खोली गई पुल रिक्वेस्ट पर सप्ताहांत की प्रतीक्षा न जुड़े।
| मेट्रिक | परिभाषा | सूत्र | इकाई | डेटा स्रोत | ITIL अभ्यास | एजाइल समकक्ष | आवृत्ति |
|---|---|---|---|---|---|---|---|
| पहली समीक्षा का समय | पुल रिक्वेस्ट के समीक्षा के लिए तैयार होने और पहली ठोस मानवीय प्रतिक्रिया के बीच की प्रतीक्षा | घड़ी तब शुरू होती है जब पुल रिक्वेस्ट ड्राफ़्ट स्थिति छोड़ती है या तैयार खोली जाती है, लेखक के अलावा किसी की पहली समीक्षा टिप्पणी, बदलाव अनुरोध या अनुमोदन पर रुकती है; बॉट और लेखक की टिप्पणियाँ और केवल लेबल बदलाव बाहर। माध्यिका और 85वाँ पर्सेंटाइल कार्य घंटों में रिपोर्ट करें | कार्य घंटे | संस्करण नियंत्रण प्लेटफ़ॉर्म का घटना इतिहास | सॉफ़्टवेयर विकास और प्रबंधन; परिवर्तन सक्षमीकरण | समीक्षा अनुक्रियाशीलता पर कार्य समझौता; प्रगति में कार्य का प्रवाह | साप्ताहिक |
| समीक्षा साइकल टाइम | समीक्षा के लिए तैयार से मर्ज तक का कुल समय | घड़ी तब शुरू होती है जब पुल रिक्वेस्ट समीक्षा के लिए तैयार हो, मर्ज पर रुकती है; बिना मर्ज के बंद की गई पुल रिक्वेस्ट बाहर और अलग गिनी जाती हैं। माध्यिका और 85वाँ पर्सेंटाइल कार्य घंटों में रिपोर्ट करें | कार्य घंटे | संस्करण नियंत्रण प्लेटफ़ॉर्म का घटना इतिहास | तैनाती प्रबंधन; परिवर्तन सक्षमीकरण | टीम बोर्ड पर समीक्षा चरण का साइकल टाइम | साप्ताहिक |
| पुल रिक्वेस्ट का आकार | पुल रिक्वेस्ट में बदलाव की मात्रा | जोड़ी गई पंक्तियाँ जमा हटाई गई पंक्तियाँ, जनरेट की फ़ाइलें, लॉक फ़ाइलें, वेंडर किया कोड और केवल नाम बदलाव छोड़कर, जैसा रिपॉज़िटरी के अनदेखा नियमों में सूचीबद्ध है। प्रति मर्ज पुल रिक्वेस्ट माध्यिका और 85वाँ पर्सेंटाइल रिपोर्ट करें | बदली पंक्तियाँ | संस्करण नियंत्रण प्लेटफ़ॉर्म के diff आँकड़े | सॉफ़्टवेयर विकास और प्रबंधन | छोटा बैच आकार; स्टोरी की स्लाइसिंग | साप्ताहिक |
| समीक्षा चक्र | मर्ज से पहले लेखक के पुश और समीक्षक के उत्तर के लूप की संख्या | प्रति मर्ज पुल रिक्वेस्ट अलग "बदलाव अनुरोधित" या टिप्पणी-फिर-पुश चक्रों की गिनती; पहला जमा शून्य चक्र है और स्वचालित जाँच विफलताएँ बाहर। माध्यिका और 85वाँ पर्सेंटाइल रिपोर्ट करें | गिनती | संस्करण नियंत्रण प्लेटफ़ॉर्म की समीक्षा और पुश घटनाएँ | सतत सुधार; सॉफ़्टवेयर विकास और प्रबंधन | समीक्षा चरण में पुनर्कार्य संकेत; पूर्णता की परिभाषा | साप्ताहिक |
| समीक्षा भार संकेंद्रण | टीम में समीक्षा कार्य कितना असमान फैला है | चलते 4 सप्ताहों में टीम की पूरी समीक्षाओं का वह हिस्सा जो दो सबसे व्यस्त समीक्षक सँभालते हैं; अपनी ही पुल रिक्वेस्ट की समीक्षाएँ और बॉट समीक्षाएँ बाहर। टीम के लिए रिपोर्ट, नाम से कभी नहीं | प्रतिशत | टीम तक समेकित संस्करण नियंत्रण प्लेटफ़ॉर्म की समीक्षा घटनाएँ | सतत सुधार; ज्ञान प्रबंधन | साझा कोड स्वामित्व; सामूहिक स्वामित्व | मासिक |
| बासी पुल रिक्वेस्ट की गिनती | टीम की सहमत सीमा से अधिक देर खुली पुल रिक्वेस्ट | अब भी खुली और ड्राफ़्ट में न रहने वाली पुल रिक्वेस्ट जिनकी समीक्षा के लिए तैयार होने के बाद की आयु टीम की सीमा से अधिक है, स्नैपशॉट समय पर गिनी हुई; ड्राफ़्ट बाहर | गिनती | संस्करण नियंत्रण प्लेटफ़ॉर्म की खुली पुल रिक्वेस्ट सूची | परिवर्तन सक्षमीकरण; सतत सुधार | कार्य मद की आयु; WIP सीमा | साप्ताहिक |
| मर्ज के बाद सुधार दर | मर्ज की गई पुल रिक्वेस्ट का हिस्सा जिसके बाद जल्द ही सुधारात्मक बदलाव आया | मर्ज की गई पुल रिक्वेस्ट जिनके 14 दिनों के भीतर उसी बदलाव से जुड़ा सुधार, रिवर्ट या हॉटफ़िक्स आया / अवधि में मर्ज की गई पुल रिक्वेस्ट; वैसे लेबल किए नियोजित अनुवर्ती कार्य बाहर | प्रतिशत | संस्करण नियंत्रण इतिहास, जुड़े इश्यू, और घटना या बदलाव रिकॉर्ड | परिवर्तन सक्षमीकरण; घटना प्रबंधन | गुणवत्ता अंतर्निहित; पूर्णता की परिभाषा | मासिक |
पहली समीक्षा का समय सबसे बड़ा लीवर है और वह माप जिससे अधिकांश टीमों को शुरू करना चाहिए। समीक्षा साइकल टाइम उसका परिणाम माप है और विषय 2.2 में चर्चित लंबे लीड टाइम का घटक। 14 दिन की खिड़की और बासी सीमा उदाहरण हैं; हर टीम अपनी रिलीज़ लय के अनुकूल मान चुनती है और उन्हें लिखती है। जहाँ संख्याएँ व्यापक डिलीवरी तस्वीर में जाती हैं, वहाँ DORA परिवार (देखें विषय 2.8, DORA मेट्रिक्स) और बदलाव विफलता माप (देखें विषय 4.4, परिवर्तन विफलता और पुनर्कार्य) सँभालते हैं।
सिफ़ारिशें
काम से पहले प्रतीक्षा मापें
1. पहली समीक्षा के समय से शुरू करें। यह आमतौर पर समीक्षा समय का सबसे बड़ा योगदानकर्ता और सुधारने में सबसे सस्ता है। इसे प्लेटफ़ॉर्म के घटना इतिहास से इंस्ट्रूमेंट करें ताकि किसी को कुछ दर्ज न करना पड़े। माध्यिका और ऊँचा पर्सेंटाइल रिपोर्ट करें, क्योंकि तीन घंटे की माध्यिका के साथ चार दिन का 95वाँ पर्सेंटाइल बताता है कि कुछ बदलाव भुलाए जा रहे हैं।
2. बॉट और ड्राफ़्ट को घड़ी से बाहर रखें, और कहें कि ऐसा है। स्वचालित जाँचें, निर्भरता अपडेट बॉट और फ़ॉर्मैटिंग उपकरण सेकंडों में टिप्पणियाँ बनाते हैं, और उन्हें गिनना प्रतीक्षा को उत्कृष्ट दिखाता है। घड़ी तब शुरू करें जब लेखक बदलाव को तैयार चिह्नित करे, न कि जब ब्रांच पहली बार पुश हो। इन नियमों को चार्ट के बगल में प्रकाशित करें।
3. कार्य घंटे उपयोग करें, और टीम का कैलेंडर लिखें। शुक्रवार को देर से खोली गई पुल रिक्वेस्ट पर सप्ताहांत की प्रतीक्षा नहीं लगनी चाहिए। समय क्षेत्रों में फैली टीम को नियम चाहिए कि किसके घंटे गिने जाएँ, और अक्सर ईमानदार उत्तर यह होता है कि क्षेत्रों के पार हैंडऑफ़ की लागत ही देखने लायक चीज़ है। चुनाव बताएँ और उसे स्थिर रखें।
काम को समीक्षा योग्य बनाएँ
4. पुल रिक्वेस्ट छोटी रखें, और आकार को टीम की आदत मानें। आकार की माध्यिका और 85वाँ पर्सेंटाइल ट्रैक करें, और बड़ी वालों को अलग-अलग विफलताओं की बजाय एक समूह के रूप में देखें। टीमें आमतौर पर पाती हैं कि बड़े बदलाव कुछ कारणों से आते हैं: काम पर्याप्त बारीकी से नहीं काटा गया, रीफ़ैक्टरिंग को नए व्यवहार से मिलाना, या मर्ज करने में बहुत देर करना। काम को इस तरह काटें कि हर पुल रिक्वेस्ट एक ही काम करे, जो ट्रंक-आधारित विकास और बार-बार तैनाती के पीछे के छोटे बैच सिद्धांत से भी मेल खाता है।
5. कठोर आकार सीमा को लक्ष्य न बनाएँ। "400 पंक्तियों से अधिक नहीं" जैसी सीमा बदलाव को कृत्रिम टुकड़ों में बाँटने को न्योता देती है जो अलग-अलग अपठनीय हैं या अकेले मर्ज होने पर बिल्ड तोड़ते हैं। आकार को रेट्रोस्पेक्टिव में बातचीत शुरू करने वाले के रूप में उपयोग करें, और टीम को काटने की तकनीकें दें, जैसे फ़ीचर टॉगल, अपनी अलग पुल रिक्वेस्ट में तैयारी वाली रीफ़ैक्टरिंग, और झंडे के पीछे मर्ज करना।
6. समीक्षा अनुरोध को स्पष्ट बनाएँ। जो पुल रिक्वेस्ट किसी समीक्षक का नाम नहीं लेती वह स्वयंसेवक का इंतज़ार करती है, और स्वयंसेवक दुर्लभ हैं। कार्य समझौते में सहमत हों कि किससे माँगा जाए, टीम को कैसे सूचित किया जाए, और उत्तर की अपेक्षा क्या है। साझा समीक्षा रोटा, या दैनिक समीक्षा स्लॉट, आमतौर पर किसी भी उपकरण सेटिंग से अधिक प्रतीक्षा घटाता है।
भार और ज्ञान फैलाएँ
7. भार संकेंद्रण को टीम-स्तर के जोखिम के रूप में देखें। यदि दो लोग अधिकांश समीक्षाएँ सँभालते हैं, तो उनकी उपलब्धता टीम के प्रवाह को सीमित करती है, और उनकी अनुपस्थिति उसे रोकती है। संकेंद्रण माप की मासिक समीक्षा करें, और टीम के डिज़ाइन से कार्रवाई करें: डिफ़ॉल्ट समीक्षक बदलते रहें, नए सदस्यों को अनुभवी लोगों के साथ जोड़ें, और कोड के उन क्षेत्रों को लिखें जिनकी समीक्षा केवल एक व्यक्ति कर सकता है। प्रति-व्यक्ति लीडरबोर्ड प्रकाशित न करें।
8. समीक्षा का उपयोग ज्ञान साझा करने के लिए करें, और उस उद्देश्य की रक्षा करें। समीक्षा के दीर्घकालिक मूल्य में खामी पहचानने के साथ सीखना, साझा स्वामित्व और सुसंगत शैली शामिल हैं। पेयर प्रोग्रामिंग और मॉब प्रोग्रामिंग उस आदान-प्रदान का कुछ हिस्सा प्रक्रिया में पहले ले जाती हैं; जहाँ जोड़ी ने पहले ही किसी बदलाव पर काम किया है, वहाँ हल्की समीक्षा उचित है। चुनाव को टीम का निर्णय बनाएँ, कार्य समझौते में लिखा, ताकि "जोड़ी में हुआ, इसलिए हल्की समीक्षा" दृश्य नियम हो, बहाना नहीं।
समीक्षा को स्वयं नियंत्रित करें
9. स्वचालन को वह करने दें जो स्वचालन अच्छी तरह करता है। फ़ॉर्मैटिंग, लिंटिंग और बुनियादी जाँचें पाइपलाइन में हैं, ताकि मानवीय ध्यान डिज़ाइन, शुद्धता और जोखिम पर जाए। स्थैतिक प्रोग्राम विश्लेषण और स्वचालित परीक्षण तुच्छ समीक्षा चक्रों की संख्या घटाते हैं। शेष चक्र तब डिज़ाइन बातचीत के बारे में अधिक और शैली की असहमतियों के बारे में कम बताते हैं।
10. समीक्षा चक्रों को स्पष्टता का संकेत पढ़ें, दोषों की गिनती नहीं। कई चक्रों का अर्थ हो सकता है कि आवश्यकता अस्पष्ट थी, लेखक के पास संदर्भ नहीं था, समीक्षक ने रुचि के बदलाव माँगे, या बदलाव बड़ा था। हर पुल रिक्वेस्ट पर शून्य चक्र का अर्थ उत्कृष्ट काम हो सकता है या यह कि किसी ने देखा ही नहीं। असामान्य रूप से अधिक या असामान्य रूप से कम चक्रों वाली मुट्ठी भर पुल रिक्वेस्ट का नमूना लें और उन्हें टीम के रूप में साथ पढ़ें।
गति को गुणवत्ता से जोड़ें, और समय को दृश्य रखें
11. समीक्षा गति के बगल में हमेशा गुणवत्ता समकक्ष दिखाएँ। मर्ज के बाद सुधार दर, हाल के बदलावों से जुड़ी घटनाएँ, और रिलीज़ के बाद मिली खामियों का हिस्सा स्वाभाविक साथी हैं (देखें विषय 4.4, परिवर्तन विफलता और पुनर्कार्य)। यदि समीक्षा समय सुधरे जबकि सुधार दर बिगड़े, तो टीम ने गति के लिए आश्वासन का सौदा किया है, और समाधान बातचीत है, लक्ष्य नहीं। दोनों एक ही चार्ट पर दिखाएँ।
12. समीक्षा को प्रवाह तस्वीर और अनियोजित कार्य से जोड़ें। तेज़ समीक्षा तभी मदद करती है जब अगला चरण काम को केवल कतार में न डाल दे (देखें विषय 2.3, प्रगति में कार्य और कतारें)। नियोजित कार्य को बाधित करने वाले तत्काल समीक्षा अनुरोधों की अपनी लागत है (देखें विषय 2.9, परिचालन कार्य और अनियोजित कार्य)।
हेरफेर के तरीके और रेलिंग
| मेट्रिक | हेरफेर कैसे होता है | जोड़ी गई रेलिंग मेट्रिक या अभ्यास |
|---|---|---|
| पहली समीक्षा का समय | पहली प्रतिक्रिया के रूप में तुरंत "ठीक दिखता है" या इमोजी पोस्ट करना; बॉट या मित्र समीक्षक सौंपना; पुल रिक्वेस्ट को तब तैयार चिह्नित करना जब कोई पहले से देखने को सहमत हो | मर्ज के बाद सुधार दर; बिना टिप्पणी वाले अनुमोदनों का नमूना; कार्य समझौते में पहली प्रतिक्रिया का ठोस होना अनिवार्य करें |
| समीक्षा साइकल टाइम | समीक्षा की प्रतीक्षा किए बिना मर्ज करना; तेज़ी से पास करने के लिए बदलाव को छोटे टुकड़ों में बाँटना; घड़ी रीसेट करने के लिए पुल रिक्वेस्ट बंद करके फिर खोलना | बंद-और-फिर-खोली पुल रिक्वेस्ट गिनें; समीक्षा चक्र; मर्ज के बाद सुधार दर; सुरक्षित ब्रांच नियम जो अनुमोदन माँगें |
| पुल रिक्वेस्ट का आकार | फ़ाइलें गिनती से बाहर करना; एकल बदलाव को ऐसे टुकड़ों में बाँटना जो अलग समझे नहीं जा सकते; जनरेट किए कोड से आकार भरना | हर तिमाही अनदेखा नियमों की समीक्षा; जाँचें कि बाँटे टुकड़े अकेले बिल्ड और परीक्षण पास करते हैं; सबसे छोटी और सबसे बड़ी का नमूना पढ़ें |
| समीक्षा चक्र | गिनती कम रखने के लिए पहले ही पास में स्वीकृत करना; चर्चा चैट में ले जाना ताकि कोई निशान न रहे; चक्र छिपाने के लिए लेखकों द्वारा एक कमिट में कई सुधार-पुश करना | मर्ज के बाद सुधार दर; शून्य-चक्र पुल रिक्वेस्ट का नमूना; चर्चा पुल रिक्वेस्ट में रखें |
| समीक्षा भार संकेंद्रण | गिनती फैलाने के लिए समीक्षाओं को कई छोटे अनुमोदनों में बाँटना; समीक्षाएँ उन्हें सौंपना जिनके पास समय है पर ज्ञान नहीं | जोखिम वाले क्षेत्रों के लिए समीक्षक के ज्ञान की समीक्षा; क्षेत्र के अनुसार मर्ज के बाद सुधार दर देखें; मेट्रिक को टीम स्तर पर रखें |
| बासी पुल रिक्वेस्ट की गिनती | बासी पुल रिक्वेस्ट को बिना मर्ज के बंद करना; उन्हें छिपाने के लिए ड्राफ़्ट में बदलना; बासी सीमा बढ़ाना | बिना मर्ज के बंद की गई पुल रिक्वेस्ट की गिनती; लंबे चलते ड्राफ़्ट की गिनती; हर तिमाही टीम के साथ सीमा की समीक्षा |
| मर्ज के बाद सुधार दर | बिना कड़ी के नई कार्य मद के तहत सुधार दर्ज करना; सुधारात्मक कार्य को नियोजित अनुवर्ती लेबल करना; खिड़की के बाद तक सुधार टालकर मेट्रिक से बचना | घटना और बदलाव विफलता डेटा से तुलना; अनुवर्ती मदों का नमूना; प्रयुक्त लेबलों का ऑडिट |
स्वस्थ पठन शांत होता है। पहली समीक्षा का समय छोटा है और पूँछ भी छोटी है, इसलिए कोई पुल रिक्वेस्ट दिनों इंतज़ार नहीं करती। आकार उस सीमा में है जिसे टीम पढ़ने में आसान पाती है, और कुछ बड़े बदलाव जिन्हें टीम समझा सकती है। समीक्षा चक्र कम हैं पर शून्य नहीं, भार संकेंद्रण मध्यम है, बासी गिनती छोटी है, और मर्ज के बाद सुधार दर स्थिर है। जब कोई संख्या तेज़ी से सुधरे, तो किसी को जाँचना चाहिए कि उसकी जोड़ी गई रेलिंग गलत दिशा में तो नहीं गई।
समझौते: लाभ और हानि
| दृष्टिकोण | ताकत | कमज़ोरी |
|---|---|---|
| कड़ी प्रतिक्रिया अपेक्षाओं के साथ तेज़ समीक्षा | छोटे प्रतिक्रिया चक्र; लेखक के लिए कम संदर्भ हानि; कम प्रगति में कार्य | जल्दी स्वीकृत करने का दबाव; केंद्रित काम में व्यवधान |
| धीमी, गहन समीक्षा | डिज़ाइन और जोखिम की सावधान पठन; मज़बूत ज्ञान हस्तांतरण | लंबा साइकल टाइम; बड़े बैच बनते हैं; लेखक आगे बढ़ जाते हैं और संदर्भ खो देते हैं |
| छोटी पुल रिक्वेस्ट | पढ़ना और वापस लेना आसान; सहज प्रवाह | प्रति बदलाव अधिक ओवरहेड; सुविधा को भ्रामक चरणों में बाँट सकता है |
| बड़ी पुल रिक्वेस्ट | कम हैंडऑफ़; पूरी सुविधा एक साथ दिखती है | समीक्षाएँ उथली; वापस लेना कठिन; लंबी प्रतीक्षा |
| नामित स्वामी से आवश्यक अनुमोदन | जोखिम वाले क्षेत्रों के लिए स्पष्ट जवाबदेही; परिवर्तन प्राधिकरण का समर्थन | बाधा और एकल विफलता बिंदु पैदा करता है |
| मानवीय समीक्षा से पहले स्वचालित जाँचें | लोगों को डिज़ाइन और जोखिम के लिए मुक्त करता है; सुसंगत | झूठा आत्मविश्वास पैदा कर सकता है; रखरखाव चाहिए |
कोई एक नीति नहीं जीतती। उद्देश्य जाँच बनाए रखते हुए प्रतीक्षा घटाना है, और आमतौर पर रास्ता है छोटे बदलाव, स्पष्ट समीक्षा अपेक्षाएँ, नियमित जाँचों के लिए मज़बूत स्वचालन, और इस पर टीम सहमति कि अच्छी समीक्षा कैसी दिखती है। समीक्षा मेट्रिक्स रेट्रोस्पेक्टिव के लिए प्रश्नों के रूप में सबसे उपयोगी और लक्ष्य के रूप में सबसे कम उपयोगी हैं।
अपनी टीम के साथ चर्चा के प्रश्न
1. पुल रिक्वेस्ट अपना अधिकांश जीवन कहाँ बिताती है, इंतज़ार में या समीक्षा में? डेटा देखने से पहले टीम से अंदाज़ा लगाने को कहें, फिर पहली समीक्षा के समय और मर्ज तक के शेष समय का विभाजन दिखाएँ। अधिकांश समूह इससे हैरान होते हैं कि कितना हिस्सा प्रतीक्षा है। सुगमकर्ता को नोट करना चाहिए कि कौन-से अंदाज़े गलत थे और पूछना चाहिए कि हर गलत अंदाज़ा इस बारे में क्या बताता है कि टीम समीक्षा को कैसे अनुभव करती है। सबसे बड़ी प्रतीक्षा पर प्रहार करने वाले एक बदलाव पर समाप्त करें।
2. इस टीम में अच्छी समीक्षा कैसी दिखती है, और बाहरी व्यक्ति कैसे बताएगा? वे व्यवहार सूचीबद्ध करें जिन्हें टीम महत्व देती है, जैसे डिज़ाइन के बारे में पूछना, परीक्षण जाँचना, और अनुरोध का कारण समझाना। फिर पूछें कि उनमें से कौन-से पुल रिक्वेस्ट में दृश्य निशान छोड़ते हैं। चर्चा करें कि व्यक्तियों की निगरानी किए बिना ठोस पहली प्रतिक्रिया को प्रतीकात्मक से कैसे अलग पहचानें। कार्य समझौते में डालने के लिए संक्षिप्त लिखित विवरण पर सहमत हों।
3. हमारे लिए कितना बड़ा बहुत बड़ा है, और जब काम सचमुच बड़ा हो तो हम क्या करें? आकार वितरण देखें और कुछ सबसे बड़ी पुल रिक्वेस्ट चुनें। पूछें कि हर एक बड़ी क्यों थी और क्या उसे काटा जा सकता था। फ़ीचर टॉगल, तैयारी वाली रीफ़ैक्टरिंग, और झंडे के पीछे मर्ज करने जैसी तकनीकों पर चर्चा करें। सुगमकर्ता को संख्यात्मक सीमा तय करने का विरोध करना चाहिए और इसकी बजाय ऐसी आदत पर सहमत होना चाहिए जिसे टीम एक महीना आज़माएगी।
4. हमारे सबसे जोखिम वाले कोड की समीक्षा कौन करता है, और जब वे दूर हों तो क्या होता है? कोड के क्षेत्रों को उन लोगों से मैप करें जो उनकी अच्छी समीक्षा कर सकते हैं। भार संकेंद्रण और एकल योग्य समीक्षक वाले क्षेत्र देखें। चर्चा करें कि हर एक में पेयरिंग या असाइनमेंट घुमाकर दूसरा समीक्षक कैसे बढ़ाएँ। बातचीत को टीम की लचीलेपन के बारे में रखें, किसी व्यक्ति के कार्यभार की रैंकिंग के बारे में नहीं।
5. यदि हमारी समीक्षा की गति कल दोगुनी हो जाए, तो हम गुणवत्ता के बारे में क्या सच चाहेंगे? समूह से वे गुणवत्ता संकेत बताने को कहें जिन पर वे नज़र रखेंगे, जैसे मर्ज के बाद सुधार, हाल के बदलावों से जुड़ी घटनाएँ, या रिवर्ट की संख्या। जाँचें कि क्या वे संकेत वर्तमान में गति चार्ट के बगल में दृश्य हैं। चर्चा करें कि इसका शुरुआती संकेत क्या होगा कि गति जाँच की कीमत पर खरीदी गई है। तय करें कि डैशबोर्ड पर कौन-सा समकक्ष दिखाएँ।
6. समीक्षा के कौन-से आँकड़े हम ऐसे सुधारने को ललचाएँगे जो मदद न करे? हर माप से गुज़रें और पूछें कि दबाव में व्यक्ति कुछ बेहतर किए बिना उसे बेहतर कैसे दिखा सकता है। उत्तरों की ऊपर की हेरफेर तालिका से तुलना करें और टीम के अपने विचार जोड़ें। उद्देश्य जोखिम को घटित होने से पहले नाम देना है। सहमत हों कि हर माप के साथ कौन-सी रेलिंग की समीक्षा होगी।
चार दृष्टिकोण
उत्पाद और डिलीवरी टीमें
डिलीवरी टीमें समीक्षा प्रक्रिया की स्वामी हैं और उन्हें उसकी मेट्रिक्स की भी स्वामी होना चाहिए। उन्हें सरल समझौतों से प्रतीक्षा घटाने से सबसे अधिक लाभ होता है: दैनिक समीक्षा स्लॉट, स्पष्ट अनुरोध प्रक्रिया, और छोटे बदलाव। उन्हें संख्याओं का उपयोग रेट्रोस्पेक्टिव में करना चाहिए, प्रगति में कार्य कम रखना चाहिए, और एकल चार्ट को अनुकूलित करने के प्रलोभन का विरोध करना चाहिए। समीक्षा वह जगह भी है जहाँ नए सदस्य कोडबेस सीखते हैं, इसलिए उस उद्देश्य की रक्षा करें।
सेवा और संचालन टीमें
संचालन टीमें समीक्षा से तब मिलती हैं जब इन्फ़्रास्ट्रक्चर कोड, विन्यास और रनबुक स्वचालन पुल रिक्वेस्ट के ज़रिए बदले जाते हैं। उनके लिए समीक्षा अक्सर इसका हिस्सा है कि मानक बदलाव कैसे स्वीकृत और प्रमाणित होता है (देखें विषय 4.3, परिवर्तन सक्षमीकरण मेट्रिक्स)। उन्हें सहमत होना चाहिए कि कौन-से बदलावों को दूसरे व्यक्ति की समीक्षा चाहिए, तत्काल सुधारों की समीक्षा कितनी जल्दी हो, और आपातकालीन बदलावों की बाद में समीक्षा कैसे हो, ताकि जल्दबाज़ी का सुधार भी जाँचा जाए। जोखिम वाले बदलाव पर पतली समीक्षा बाद में घटना के रूप में दिखती है।
नेतृत्व और शासन
नेताओं को समीक्षा मेट्रिक्स को टीम स्वास्थ्य और प्रवाह के संकेत मानना चाहिए, उत्पादकता स्कोर नहीं। उन्हें जब भी गति संख्या रिपोर्ट हो तो जोड़ा गया गुणवत्ता माप माँगना चाहिए, सावधान समीक्षा में लगने वाले समय का समर्थन करना चाहिए, और कच्चे समीक्षा समय पर टीमों की तुलना से बचना चाहिए, क्योंकि रिपॉज़िटरी और जोखिम भिन्न हैं। शासन निकाय समीक्षा प्रमाण को बदलाव आश्वासन के हिस्से के रूप में उपयोग कर सकते हैं, बशर्ते वे स्वीकार करें कि प्रलेखित, नमूना-आधारित समीक्षा प्रक्रिया अनुमोदनों की गिनती से मज़बूत है।
ग्राहक और उपयोगकर्ता
ग्राहक पुल रिक्वेस्ट नहीं देखते, फिर भी वे परिणाम महसूस करते हैं: सुधार कितनी जल्दी पहुँचता है और रिलीज़ कितनी बार नई खामी लाती है। छोटी समीक्षा प्रतीक्षाएँ तत्काल सुधारों को उन तक जल्दी पहुँचाने में मदद करती हैं, और विचारशील समीक्षा खराबियों को उनसे दूर रखने में। जहाँ सेवा का प्रकाशित रिलीज़ या खामी इतिहास है, वहाँ ग्राहकों को टीम के समय के साथ कम वापसियाँ और कम दोहराए सुधार दिखाने से लाभ होता है।
व्यवहार में: एक एजाइल ITIL उदाहरण
एक क्षेत्रीय अस्पताल का आईटी विभाग मरीज़-नियुक्ति वेब सेवा चलाता है, जिसे सात की एक उत्पाद टीम ने बनाया है और छोटे साइट विश्वसनीयता समूह के साथ संचालित किया जाता है। इस उदाहरण की सभी संख्याएँ उदाहरणार्थ संख्याएँ हैं।
तिमाही समीक्षा में टीम पाती है कि उसके समीक्षा साइकल टाइम की माध्यिका 26 कार्य घंटे और 85वाँ पर्सेंटाइल 71 कार्य घंटे है (उदाहरणार्थ)। चक्र को बाँटने पर पता चलता है कि पहली समीक्षा के समय की माध्यिका 19 कार्य घंटे है, इसलिए अधिकांश देरी प्रतीक्षा है। पुल रिक्वेस्ट के आकार की माध्यिका 180 पंक्तियाँ और 85वाँ पर्सेंटाइल 900 पंक्तियाँ है (उदाहरणार्थ), और दो सबसे व्यस्त समीक्षक 68 प्रतिशत समीक्षाएँ सँभालते हैं (उदाहरणार्थ)। मर्ज के बाद सुधार दर 9 प्रतिशत है (उदाहरणार्थ)।
टीम तीन समझौते करती है। वे दैनिक 30 मिनट का समीक्षा स्लॉट तय करती है, एक कार्य दिवस के भीतर पहली प्रतिक्रिया की अपेक्षा अपने कार्य समझौते में लिखती है, और हर सप्ताह "पहले समीक्षा" कर्तव्य घुमाती है। वे बड़े काम के लिए काटने की आदत भी अपनाती हैं, फ़ीचर टॉगल का उपयोग करके ताकि आंशिक सुविधाएँ सुरक्षित रूप से मर्ज हो सकें। वे आकार सीमा या पहली समीक्षा के समय का लक्ष्य तय नहीं करतीं।
दो महीने बाद पहली समीक्षा के समय की माध्यिका 6 कार्य घंटे तक गिरती है और समीक्षा साइकल टाइम का 85वाँ पर्सेंटाइल 34 कार्य घंटे तक (उदाहरणार्थ)। भार संकेंद्रण 52 प्रतिशत तक घटता है (उदाहरणार्थ), और मर्ज के बाद सुधार दर 9 प्रतिशत पर टिकी रहती है।
फिर टीम हेरफेर का जोखिम पकड़ती है। स्वीकृतियों का नमूना दिखाता है कि नियुक्ति-अनुस्मारक तर्क को छूते बदलावों पर लगभग एक तिहाई पहली प्रतिक्रियाएँ मिनटों में आती हैं और केवल "LGTM" पढ़ती हैं। गति का लाभ आंशिक रूप से वास्तविक था और आंशिक रूप से रबर स्टैंप। मर्ज के बाद सुधार दर अभी नहीं हिली थी क्योंकि प्रभावित कोड मासिक चक्र पर चलता है। टीम कार्य समझौता बदलती है ताकि पहली प्रतिक्रिया में या तो प्रश्न, बदलाव के किसी विशिष्ट हिस्से पर टिप्पणी, या जाँचा गया क्या यह स्पष्ट नोट शामिल हो, और अपने समीक्षा चार्ट में बिना टिप्पणी वाले अनुमोदनों का नमूना हिस्सा जोड़ती है। वे यह भी सहमत होती हैं कि मरीज़-दृश्य अनुस्मारक तर्क के बदलावों को दो समीक्षक चाहिए, जिनमें से एक संचालन समूह से हो। कारणों सहित निर्णय टीम के निर्णय लॉग में जाता है।
क्षेत्र के अनुसार दृष्टि
स्टार्टअप। छोटी टीम मिनटों में समीक्षा कर सकती है क्योंकि हर कोई कोड जानता है, और मुख्य जोखिम समय कम होने पर समीक्षा छोड़ना है। मेट्रिक्स कम रखें: पहली समीक्षा का समय और आकार पर्याप्त हैं। छोटे बदलावों की आदत जल्दी स्थापित करें, क्योंकि कोडबेस और टीम बढ़ने के बाद उसे लाना कहीं कठिन है।
छोटा व्यवसाय। अक्सर एक या दो डेवलपर, या बाहरी आपूर्तिकर्ता, सॉफ़्टवेयर बनाए रखते हैं। समीक्षा एक सहकर्मी या आपूर्तिकर्ता के अपने कर्मचारी कर सकते हैं। आपूर्तिकर्ताओं से पूछें कि वे समीक्षा कैसे करते हैं और क्या पुल रिक्वेस्ट डेटा साझा किया जा सकता है, और रखें कि किन बदलावों की समीक्षा किसने की इसका सरल रिकॉर्ड, क्योंकि छोटी टीम में समीक्षा गलतियों के विरुद्ध मुख्य जाँच है।
उद्यम। कई टीमें, रिपॉज़िटरी और अनुमोदन नियम व्यापक भिन्नता पैदा करते हैं। घड़ियों और अपवादों की परिभाषाएँ मानकीकृत करें ताकि प्लेटफ़ॉर्म डेटा तुलनीय हो, पर कच्चे समीक्षा समय पर टीमों को रैंक न करें, क्योंकि जोखिम और कोडबेस भिन्न हैं। ऑडिट के लिए थोपी समीक्षा आवश्यकताओं पर नज़र रखें जो बिना जाँच जोड़े प्रतीक्षा जोड़ती हैं, और हाथ के अनुमोदनों को स्वचालित जाँचों और नमूना समीक्षा से बदलने के अवसर खोजें।
सरकार और सार्वजनिक क्षेत्र। कर्तव्यों का पृथक्करण, ऑडिट ट्रेल और खरीद नियम अक्सर बदलावों के लिए स्वतंत्र अनुमोदन माँगते हैं। उन नियमों को डिज़ाइन के इनपुट मानें: दर्ज करें किसने क्या कब स्वीकृत किया, और वे जो प्रतीक्षा बनाते हैं उसे मापें। जहाँ आपूर्तिकर्ता कोड लिखते हैं, अनुबंध में समीक्षा प्रमाण और डेटा पहुँच बताएँ (देखें विषय 8.5, विनियमित और सरकारी रिपोर्टिंग)।
व्यावसायिक औचित्य: प्रेरणाएँ, ROI और TCO
प्रेरणा डिलीवरी के उस हिस्से को छोटा करना है जो धीमा भी है और नियंत्रणीय भी, जबकि सहकर्मी समीक्षा के लाभ बनाए रखना: कम खामियाँ, साझा ज्ञान और ऑडिट ट्रेल। प्रतीक्षारत पुल रिक्वेस्ट पूरा किया काम उपयोगकर्ताओं तक पहुँचने से रोकती हैं, लेखकों के संदर्भ-बदलाव की लागत बढ़ाती हैं, और ब्रांच के पुराने होने पर मर्ज टकराव की संभावना बढ़ाती हैं। इसलिए प्रतीक्षा घटाना तेज़ डिलीवरी, कम पुनर्कार्य और कम निराशा से प्रतिफल देता है।
इन मेट्रिक्स को इकट्ठा करने की लागत कम है जब संस्करण नियंत्रण प्लेटफ़ॉर्म घटना इतिहास और API देता है। मुख्य लागत घड़ियाँ और अपवाद परिभाषित करने, रिपोर्ट बनाने या विन्यस्त करने, और संख्याओं की नियमित समीक्षा करने का समय हैं। बड़ी लागत व्यवहारगत है: समय जो लोग शीघ्र समीक्षा करने को देते हैं, जो अन्य कार्य से प्रतिस्पर्धा करता है। वह समय असली निवेश है, और उसे मुफ़्त मानने की बजाय बजट किया जाना चाहिए।
प्रतिफल छोटे समीक्षा साइकल टाइम, कम बासी पुल रिक्वेस्ट, और स्थिर या गिरती मर्ज के बाद सुधार दर के रूप में दिखता है। पहले से किसी विशिष्ट प्रतिशत सुधार का दावा न करें, क्योंकि नतीजे शुरुआती बिंदु और टीम पर निर्भर हैं। विश्वसनीय औचित्य टीम के अपने पहले और बाद के वितरणों की तुलना करता है, उसके गुणवत्ता समकक्ष के साथ, अन्य संगठनों के आँकड़े उद्धृत करने की बजाय। 2018 की पुस्तक Accelerate तकनीकी और सांस्कृतिक अभ्यासों को डिलीवरी प्रदर्शन से जोड़ने वाला शोध रिपोर्ट करती है और सामान्य तर्क के लिए उचित स्रोत है, पर आपकी टीम की संख्याएँ आपके अपने डेटा से आती हैं।
प्रति-पैटर्न और जाल
- समीक्षकों या लेखकों को रैंक करना। पूरी की गई समीक्षाओं या बदली पंक्तियों के व्यक्तिगत लीडरबोर्ड सहयोग को बिगाड़ते हैं। टीम स्तर पर रिपोर्ट करें और संख्याओं का उपयोग टीम की आदतें समायोजित करने के लिए करें।
- गुणवत्ता समकक्ष के बिना पहली समीक्षा के समय का लक्ष्य। नतीजा रबर स्टैंप है। हर गति चार्ट के बगल में मर्ज के बाद सुधार दर और बिना टिप्पणी वाले अनुमोदनों का नमूना दिखाएँ।
- कठोर आकार सीमा तय करना। टीमें पालन के लिए काम कृत्रिम रूप से बाँटती हैं। आकार को बातचीत के रूप में उपयोग करें और इसकी जगह काटने की तकनीकें सिखाएँ।
- शून्य टिप्पणियों को सफलता मानना। बिना जाँची स्वीकृति भरोसा या असावधानी दर्शा सकती है। ऐसी पुल रिक्वेस्ट का नमूना लें और साथ पढ़ें।
- बॉट गतिविधि को समीक्षा गिनना। स्वचालित टिप्पणियाँ प्रतीक्षा को छोटा दिखाती हैं। बॉट को घड़ी और भार मापों से बाहर रखें।
- समय क्षेत्रों और कैलेंडरों की अनदेखी। कच्चा घड़ी समय सप्ताहांत और क्षेत्र-पार प्रतीक्षाओं को धीमी समीक्षा जैसा दिखाता है। कार्य घंटे उपयोग करें और कैलेंडर का नाम लें।
- बासी सूची को बढ़ने देना। पुरानी पुल रिक्वेस्ट मर्ज टकराव जमा करती हैं और संदर्भ खो देती हैं। सूची की साप्ताहिक समीक्षा करें और हर मद को मर्ज, पुनर्कार्य, या कारण सहित बंद करें।
परिपक्वता मॉडल
| आयाम | 1 आरंभ | 2 विकास | 3 मानकीकरण | 4 प्रबंधन | 5 समन्वय |
|---|---|---|---|---|---|
| परिभाषा और घड़ियाँ | समीक्षा समय का अंदाज़ा लगाया जाता है या महसूस से रिपोर्ट होता है | कुछ टीमें अपने नियमों से प्लेटफ़ॉर्म से समय निर्यात करती हैं | बॉट, ड्राफ़्ट और कैलेंडर के अपवादों सहित हर घड़ी की एक लिखित परिभाषा | परिभाषाओं की लय पर समीक्षा; बदलाव कारण सहित लॉग | टीमों और आपूर्तिकर्ताओं में परिभाषाएँ संरेखित और निर्णयों को जानकारी देना बंद करने पर संशोधित |
| समीक्षा अभ्यास | समीक्षाएँ तब होती हैं जब कोई नोटिस करता है | कुछ टीमों में अनौपचारिक मानदंड | अनुरोधों, प्रतिक्रिया अपेक्षाओं और समीक्षा क्या कवर करती है इस पर लिखित कार्य समझौता | डेटा से मानदंड समायोजित; ज्ञान साझाकरण और जोखिम क्षेत्र ट्रैक | टीमों और आपूर्तिकर्ताओं में समीक्षा अभ्यास समन्वित, नियमित जाँचें स्वचालन सँभालता है |
| गुणवत्ता समकक्ष | समीक्षा और खामियों के बीच कोई कड़ी नहीं | मर्ज के बाद सुधारों पर कभी-कभार नज़र | समीक्षा गति के बगल में मर्ज के बाद सुधार दर दिखाई जाती है | रेलिंग की नियमित समीक्षा; नमूना स्वीकृतियाँ पढ़ी जाती हैं | समीक्षा प्रमाण सेवाओं में बदलाव आश्वासन और घटना सीखने से जुड़ा |
| सुधार में उपयोग | संख्याएँ अप्रयुक्त | कुछ रेट्रोस्पेक्टिव में दिखाई जाती हैं | स्वामी टीम द्वारा निश्चित लय पर समीक्षित | अंतर नियोजित, संसाधन-युक्त सुधार कार्य की ओर ले जाते हैं | सुधार के विचार टीमों से साझा अभ्यास तक और वापस बहते हैं |
चेकलिस्ट
- पहली समीक्षा के समय और समीक्षा साइकल टाइम की घड़ियाँ आरंभ, अंत और अपवादों सहित लिखी हैं।
- बॉट, ड्राफ़्ट और बिना मर्ज के बंद पुल रिक्वेस्ट बाहर हैं या अलग गिनी जाती हैं, और नियम दृश्य हैं।
- समय कार्य घंटों में माध्यिका और ऊँचे पर्सेंटाइल के रूप में रिपोर्ट होते हैं।
- पुल रिक्वेस्ट का आकार जनरेट और वेंडर फ़ाइलों के लिए सहमत अनदेखा सूची के साथ मापा जाता है।
- टीम का लिखित समझौता है कि समीक्षाएँ कैसे माँगी जाती हैं और पहली प्रतिक्रिया कितनी जल्दी अपेक्षित है।
- समीक्षा भार संकेंद्रण केवल टीम स्तर पर रिपोर्ट होता है।
- मर्ज के बाद सुधार दर या अन्य गुणवत्ता समकक्ष समीक्षा गति के उसी चार्ट पर दिखाया जाता है।
- हर महीने बिना टिप्पणी और बहुत तेज़ स्वीकृतियों का नमूना पढ़ा जाता है।
- बासी पुल रिक्वेस्ट सूची की साप्ताहिक समीक्षा होती है।
- समीक्षा डेटा रेट्रोस्पेक्टिव में उपयोग होता है, व्यक्तिगत मूल्यांकन में नहीं।
- एकल योग्य समीक्षक वाले कोड क्षेत्र सूचीबद्ध हैं और उनकी योजना है।
AI प्रॉम्प्ट
समीक्षा मेट्रिक्स के लिए घड़ी परिभाषाओं का मसौदा बनाएँ।
मैं [टीम या रिपॉज़िटरी] के लिए समीक्षा मेट्रिक्स परिभाषित करना चाहता/चाहती हूँ। हमारा
प्लेटफ़ॉर्म [संस्करण नियंत्रण प्लेटफ़ॉर्म] है और हमारा कार्यप्रवाह है [वर्णन करें: ड्राफ़्ट पुल
रिक्वेस्ट, आवश्यक अनुमोदन, मर्ज नियम, उपयोग में बॉट]। पहली समीक्षा के समय और समीक्षा
साइकल टाइम की सटीक परिभाषाओं का मसौदा बनाएँ, यह बताते हुए कि हर घड़ी कौन-सी घटना पर
शुरू और बंद होती है, क्या बाहर है (बॉट, ड्राफ़्ट, बिना मर्ज के बंद), [समय क्षेत्र और कार्य
कैलेंडर] के लिए कार्य घंटे कैसे सँभाले जाते हैं, और कौन-से पर्सेंटाइल रिपोर्ट करें। बेंचमार्क मान
या उपकरण की विशेषताएँ न गढ़ें। अपनी मान्यताएँ और परिभाषाएँ पूरी करने के लिए मुझे किन
प्रश्नों के उत्तर देने चाहिए, सूचीबद्ध करें।
समीक्षा डेटा निर्यात का विश्लेषण करें।
यहाँ [अवधि] में [टीम] की मर्ज की गई पुल रिक्वेस्ट का अनाम निर्यात है, स्तंभों [स्तंभों की सूची,
उदाहरण के लिए तैयार समय, पहली समीक्षा का समय, मर्ज समय, बदली पंक्तियाँ, समीक्षा चक्र,
जुड़ा सुधार झंडा] के साथ: [डेटा या सारांश चिपकाएँ]। हर समय माप और आकार के लिए माध्यिका और
85वाँ पर्सेंटाइल गणना करें, समीक्षा चक्र को प्रतीक्षा और समीक्षा में बाँटें, और ऐसे पैटर्न
इंगित करें जो बातचीत के योग्य हैं। व्यक्तियों को रैंक न करें, और बाहरी बेंचमार्क से तुलना
न करें। अपनी मान्यताएँ और जो भी डेटा गुणवत्ता समस्याएँ आप नोटिस करें, सूचीबद्ध करें।
हमारी समीक्षा मेट्रिक्स में हेरफेर के जोखिम खोजें।
हमारी टीम ये समीक्षा मेट्रिक्स रिपोर्ट करती है: [मेट्रिक्स और हर एक की गणना कैसे होती है
सूचीबद्ध करें]। हम पर दबाव हैं [उदाहरण के लिए रिलीज़ की समयसीमा, नेतृत्व का लक्ष्य, आपूर्तिकर्ता
अनुबंध]। हर मेट्रिक के लिए वर्णन करें कि समीक्षा सुधारे बिना उसे कैसे सुधारा जा सकता है, हर
एक के शुरुआती संकेत, और जोड़ी गई रेलिंग मेट्रिक या अभ्यास जो उसे पकड़ेगा। आँकड़े न गढ़ें।
अपनी मान्यताएँ सूचीबद्ध करें और बताएँ कि जोखिमों को क्रमित करने के लिए आपको क्या जानना
होगा।
समीक्षा प्रवाह पर रेट्रोस्पेक्टिव तैयार करें।
[टीम] के लिए समीक्षा प्रवाह पर 45 मिनट के रेट्रोस्पेक्टिव की कार्यसूची तैयार करें। इनपुट:
पहली समीक्षा का समय [मान], समीक्षा साइकल टाइम [मान], माध्यिका आकार [मान], भार संकेंद्रण
[मान], और मर्ज के बाद सुधार दर [मान], सब अपनी परिभाषाओं के साथ लेबल किए हुए। ऐसे प्रश्न
सुझाएँ जो कारण सामने लाएँ, एक छोटा प्रयोग जो टीम [अवधि] चला सके, और प्रयोग के दौरान देखने
का गुणवत्ता संकेत। कारण या लक्ष्य न गढ़ें। अपनी मान्यताएँ और मुझे लाने वाला डेटा
सूचीबद्ध करें।
AI कौशल
- एजाइल ITIL मेट्रिक्स कौशल: संबंधित प्रवाह या गुणवत्ता मेट्रिक को परिभाषित करने वाला विषय और वह रेलिंग खोजने के लिए उपयोग करें जो समीक्षा मेट्रिक के बगल में होनी चाहिए।
- एजाइल ITIL मेट्रिक्स अनुरक्षक कौशल: यह जाँचने के लिए उपयोग करें कि इस विषय में संपादन टेम्पलेट, हेरफेर तालिका और संदर्भ सुसंगत रखते हैं।
मुख्य निष्कर्ष
- अधिकांश समीक्षा देरी प्रतीक्षा है, इसलिए पहली समीक्षा का समय और समीक्षा साइकल टाइम कार्य घंटों में वितरण के रूप में मापें।
- छोटी पुल रिक्वेस्ट की समीक्षा तेज़ और अधिक सावधानी से होती है; आकार की सीमा थोपने की बजाय काटना सिखाएँ।
- हर गति माप को मर्ज के बाद सुधार दर जैसे गुणवत्ता समकक्ष से जोड़ें, और दोनों साथ पढ़ें।
- समीक्षा भार को टीम की क्षमता मानें और संकेंद्रण टीम स्तर पर रिपोर्ट करें, लोगों की रैंकिंग के रूप में कभी नहीं।
- समीक्षा मेट्रिक्स रेट्रोस्पेक्टिव के लिए प्रश्न हैं, और वे उस टीम की सेवा करती हैं जो काम की स्वामी है।
संदर्भ और आगे पढ़ें
- 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.