Software Review के प्रकार
हर review को मीटिंग, moderator और metrics शीट की ज़रूरत नहीं होती — और कुछ review इनके बिना बेकार हैं। ISTQB Foundation Level सिलेबस (CTFL v4.0) review को औपचारिकता के पैमाने पर चार नामित प्रकारों में रखता है: informal review, walkthrough, technical review और inspection। प्रकार चुनना यह चुनना है कि किसी वर्क प्रोडक्ट को कितनी प्रक्रिया चाहिए, इस आधार पर कि defect छूट जाए तो कितना महँगा पड़ेगा।
यह पेज हर प्रकार को परिभाषित करता है, उद्देश्य, औपचारिकता, leader, भूमिकाओं, डॉक्यूमेंटेशन और metrics पर उनकी तुलना करता है, और फिर वह बताता है जो सबमें साझा है: सामान्य review प्रक्रिया, review की भूमिकाएँ और वे कारक जो review को सफल बनाते हैं। अंत में प्रकार चुनने के व्यावहारिक उदाहरण और दोबारा इस्तेमाल लायक review log है।
Review को औपचारिकता के आधार पर क्यों बाँटा जाता है
हर review प्रकार एक जैसे व्यापक लक्ष्यों के पीछे है — defects ढूँढना, क्वालिटी का आकलन, साझा समझ बनाना — पर उन्हें अलग वज़न देता है। Informal सिरे पर गति और कम लागत सबसे अहम है; formal सिरे पर गहराई, दोहराने योग्यता और प्रक्रिया सुधारने के लिए डेटा। Review जितना औपचारिक होगा, उतना ही वह सामान्य प्रक्रिया का पालन करेगा, भूमिकाएँ उतनी साफ़ अलग होंगी, और वह उतना ज़्यादा दर्ज और मापेगा।
से: Informal सिरा: गति और कम लागत
- Informal reviewऔपचारिकता सबसे कम। नेतृत्व: कोई नहीं, या author। Anomalies जल्दी ढूँढना।
- Walkthroughऔपचारिकता कम से मध्यम। नेतृत्व: author। समझ बनाना, सिखाना और नए विचार।
- Technical reviewऔपचारिकता मध्यम से ऊँची। नेतृत्व: moderator। सहमति और तकनीकी फ़ैसले।
- Inspectionऔपचारिकता सबसे ज़्यादा। नेतृत्व: review leader, कभी author नहीं। जितनी हो सकें उतनी anomalies ढूँढना।
तक: Formal सिरा: गहराई, दोहराने योग्यता, प्रक्रिया सुधारने के लिए डेटा
औपचारिकता के स्तर तुलना तालिका से हैं, जो CTFL v4.0 के खुले छोड़े विकल्पों में आम प्रैक्टिस भरती है; टीमें तरीके मिलाती भी हैं।
दो अन्य संदर्भ थोड़ी अलग शब्दावली इस्तेमाल करते हैं। सॉफ़्टवेयर review और audit का IEEE मानक IEEE 1028-2008 (जिसे IEEE inactive-reserved के रूप में सूचीबद्ध करता है) पाँच प्रकार परिभाषित करता है: management review, technical review, inspection, walkthrough और audit। इसका management review प्रगति पर नज़र रखता है और plans व schedules का आकलन करता है; audit standards, नियमों, plans या procedures के अनुपालन की स्वतंत्र जाँच है। दोनों में से कोई भी मुख्य रूप से वर्क प्रोडक्ट की तकनीकी सामग्री में defects ढूँढने के लिए नहीं है। ISO/IEC 20246 वर्क प्रोडक्ट review का सामान्य फ़्रेमवर्क — प्रक्रिया, भूमिकाएँ और तकनीकें — बताता है, जिसका ISTQB review प्रक्रिया काफ़ी करीब से पालन करती है।
Informal review
Informal review किसी तय प्रक्रिया का पालन नहीं करता और औपचारिक दर्ज आउटपुट की ज़रूरत नहीं रखता। इसका मुख्य उद्देश्य anomalies ढूँढना है। किसी सहकर्मी का pull request पढ़ना, refinement से पहले किसी टेस्टर का user story पर नज़र डालना, "ज़रा यह query देख लोगे?" वाला मैसेज: ये सब informal review हैं। Pair programming और pair testing लगातार चलने वाले informal review की तरह काम करते हैं।
Informal review सस्ते और तेज़ हैं, इसीलिए सबसे आम हैं। उनकी कमज़ोरी यह है कि गहराई की कोई जाँच नहीं होती: बिना तैयारी या checklist के informal review सिर्फ़ मंज़ूरी की मुहर बन सकता है। दो आदतें मदद करती हैं: reviewer को बताएँ कि किस पर ध्यान देना है, और formatting automated checks पर छोड़ें ताकि reviewer का ध्यान logic पर जाए।
Walkthrough
Walkthrough का नेतृत्व author करता है, जो प्रतिभागियों को वर्क प्रोडक्ट से गुज़ारता है — अक्सर किसी scenario या dry run के ज़रिए। CTFL v4.0 उद्देश्यों की एक व्यापक सूची देता है: क्वालिटी का आकलन और भरोसा बनाना, reviewers को सिखाना, सहमति बनाना, नए विचार पैदा करना, authors को सुधार के लिए प्रेरित और सक्षम करना, और anomalies ढूँढना। सत्र से पहले individual preparation हो सकती है, पर ज़रूरी नहीं।
Walkthrough उन वर्क प्रोडक्ट के लिए ठीक है जिन्हें इस्तेमाल करने के लिए दूसरों का समझना ज़रूरी है: वह test plan जो उसे चलाने वाली टीम के सामने रखा जाए, नया architecture जो उस पर बनाने वाले डेवलपरों को समझाया जाए, कोई जटिल business rule जो टेस्टरों को समझाया जाए। जोखिम यह है कि author कहानी पर नियंत्रण रखता है और कमज़ोर जगहों से आगे निकल सकता है, इसलिए कम से कम एक ऐसे प्रतिभागी को बुलाएँ जिसका काम "अगर ऐसा हो तो…?" पूछना हो।
Technical review
Technical review तकनीकी रूप से योग्य reviewers करते हैं और moderator इसका नेतृत्व करता है। इसके मुख्य उद्देश्य किसी तकनीकी समस्या पर सहमति बनाना और फ़ैसले लेना हैं; यह anomalies भी ढूँढता है, क्वालिटी आँकता है, भरोसा बनाता है, नए विचार लाता है और authors को सुधारने में मदद करता है। Reviewers से individual preparation की अपेक्षा होती है, और नतीजा — findings और फ़ैसले — दर्ज किया जाता है।
आम विषय डिज़ाइन के विकल्प और specifications हैं: दो data models में से चुनना, implementation से पहले API contract मंज़ूर करना, यह तय करना कि कोई service किसी dependency के बंद होने को कैसे संभालेगी। Moderator की क़ीमत यह है कि चर्चा किसी फ़ैसले पर ख़त्म हो, सबसे ऊँची आवाज़ वाली राय पर नहीं।
Inspection
Inspection सबसे औपचारिक review प्रकार है। यह पूरी सामान्य review प्रक्रिया का पालन करता है, और इसका मुख्य उद्देश्य जितनी हो सकें उतनी anomalies ढूँढना है; यह क्वालिटी भी आँकता है, भरोसा बनाता है और authors को सुधार के लिए प्रेरित करता है। Metrics इकट्ठा करके सॉफ़्टवेयर डेवलपमेंट लाइफ़साइकल सुधारने में इस्तेमाल होते हैं, जिसमें inspection प्रक्रिया ख़ुद शामिल है। Inspection में author, review leader या scribe की भूमिका नहीं निभा सकता।
Inspection की जड़ें 1970 के दशक में IBM में Michael Fagan के काम में हैं। व्यवहार में इसमें entry criteria (डॉक्यूमेंट inspect करने लायक पूरा है), पिछले defects से बनी checklists, हर reviewer की individual preparation, moderator द्वारा चलाई गई मीटिंग जो fixes पर बहस के बजाय findings दर्ज करती है, औपचारिक rework, और rework पूरा होने की जाँच होती है। Inspection महँगा है, इसलिए इसे उन वर्क प्रोडक्ट के लिए रखें जहाँ छूटा defect महँगा पड़ता है: payment या tax calculation rules, security-critical कोड, नियामक requirements, safety से जुड़ा logic, data migration scripts।
चारों प्रकारों की तुलना
यह तालिका CTFL v4.0 में बताई विशेषताओं का सार है, और जहाँ सिलेबस विकल्प खुला छोड़ता है वहाँ आम प्रैक्टिस भरी गई है। इसे मार्गदर्शक मानें: कोई टीम inspection जैसी checklists के साथ technical review कर सकती है, या छोटे लिखित log के साथ informal review।
Inspection metrics में आम तौर पर वर्क प्रोडक्ट का आकार, हर reviewer का preparation time, मीटिंग का समय, type और severity के अनुसार findings, finding density (प्रति पेज या प्रति हज़ार लाइन), rework effort और बाद में review से छूटे defects शामिल होते हैं। इन संख्याओं का उद्देश्य प्रक्रिया सुधारना है — author या reviewers को आँकना कभी नहीं।
- Informal review — उद्देश्य: anomalies जल्दी ढूँढना। औपचारिकता: सबसे कम। नेतृत्व: कोई नहीं, या author। भूमिकाएँ: author और एक या अधिक reviewers। तैयारी: वैकल्पिक। डॉक्यूमेंटेशन: ज़रूरी नहीं। Metrics: शायद ही कभी।
- Walkthrough — उद्देश्य: समझ बनाना, सिखाना और नए विचार। औपचारिकता: कम से मध्यम। नेतृत्व: author। भूमिकाएँ: author और प्रतिभागी। तैयारी: वैकल्पिक। डॉक्यूमेंटेशन: वैकल्पिक नोट्स। Metrics: शायद ही कभी।
- Technical review — उद्देश्य: सहमति और तकनीकी फ़ैसले। औपचारिकता: मध्यम से ऊँची। नेतृत्व: moderator। भूमिकाएँ: moderator, योग्य reviewers और scribe। तैयारी: अपेक्षित। डॉक्यूमेंटेशन: findings और फ़ैसले। Metrics: वैकल्पिक।
- Inspection — उद्देश्य: जितनी हो सकें उतनी anomalies ढूँढना। औपचारिकता: सबसे ज़्यादा। नेतृत्व: review leader, जो कभी author नहीं होता। भूमिकाएँ: सभी, साफ़ तौर पर अलग-अलग। तैयारी: ज़रूरी, checklists के साथ। डॉक्यूमेंटेशन: entry/exit criteria, log, report और rework की जाँच। Metrics: इकट्ठा करके प्रक्रिया सुधारने में इस्तेमाल।
Informal review Walkthrough Technical review Inspection
Main purpose find anomalies understanding, consensus and find as many
quickly education, ideas technical decisions anomalies as possible
Formality lowest low to medium medium to high highest
Led by nobody / author the author a moderator a review leader;
never the author
Roles author + author + moderator, qualified all roles, clearly
1..n reviewers participants reviewers, scribe separated
Preparation optional optional expected required, with checklists
Documentation none required optional notes findings + decisions entry/exit criteria, log,
report, rework check
Metrics rarely rarely optional collected and used to
improve the processसामान्य review प्रक्रिया
CTFL v4.0 ISO/IEC 20246 में परिभाषित सामान्य review प्रक्रिया की पाँच गतिविधियाँ बताता है। Review जितना औपचारिक होता है, हर गतिविधि के उतने ज़्यादा काम ज़रूरी होते हैं: inspection पूरी प्रक्रिया का पालन करता है, जबकि informal review किसी परिभाषित प्रक्रिया का पालन नहीं करता।
- Planning — scope तय करें: review का उद्देश्य, वर्क प्रोडक्ट, किन क्वालिटी विशेषताओं का आकलन होगा, किन हिस्सों पर ध्यान देना है, exit criteria, standards जैसी सहायक जानकारी, और effort व समय-सीमा।
- Review initiation — पक्का करें कि हर व्यक्ति और हर चीज़ तैयार है: प्रतिभागियों के पास वर्क प्रोडक्ट की पहुँच है, वे अपनी भूमिकाएँ और ज़िम्मेदारियाँ समझते हैं, और उनके पास checklists व संबंधित डॉक्यूमेंट जैसी ज़रूरी चीज़ें हैं।
- Individual review — हर reviewer अकेले वर्क प्रोडक्ट की जाँच करता है, checklist-based या scenario-based reviewing जैसी एक या अधिक review तकनीकें लागू करता है, और anomalies, सुझाव व सवाल दर्ज करता है।
- Communication and analysis — anomalies पर चर्चा और विश्लेषण होता है, आम तौर पर review मीटिंग में या review टूल में। हर एक के लिए समूह उसका status, owner और ज़रूरी action तय करता है, और वर्क प्रोडक्ट का क्वालिटी स्तर व कोई follow-up तय करता है, जिसमें दूसरा review भी हो सकता है।
- Fixing and reporting — जिन findings पर सुधार चाहिए उनके defect reports बनते हैं ताकि उन्हें ट्रैक किया जा सके; exit criteria पूरे होने पर वर्क प्रोडक्ट स्वीकार किया जा सकता है, और review के नतीजे रिपोर्ट किए जाते हैं।
आज़माएँ: AI Requirement अस्पष्टता डिटेक्टर आज़माएँ: AI Acceptance Criteria रिव्यूअर आज़माएँ: टेक्स्ट डिफ़
Review की भूमिकाएँ
CTFL v4.0 छह मुख्य भूमिकाएँ बताता है। Informal review में एक-दो लोग सब निभाते हैं; inspection में ये अलग-अलग लोगों को दी जाती हैं। ISO/IEC 20246 और विस्तृत भूमिकाएँ भी बताता है।
- Manager — तय करता है कि किसका review होगा और लोग व समय जैसे संसाधन देता है।
- Author — वर्क प्रोडक्ट बनाता है और review के बाद उसे ठीक करता है।
- Moderator (facilitator) — review मीटिंग का प्रभावी संचालन पक्का करता है: मध्यस्थता, समय प्रबंधन, और ऐसा सुरक्षित माहौल जिसमें हर कोई खुलकर बोल सके।
- Scribe (recorder) — reviewers से anomalies इकट्ठा करता है और फ़ैसले व मीटिंग में मिली नई anomalies जैसी review जानकारी दर्ज करता है।
- Reviewer — review करता है। Reviewer टीम का सदस्य, विषय विशेषज्ञ या कोई भी stakeholder हो सकता है; अलग दृष्टिकोण (यूज़र, टेस्टर, operations, security) वाले reviewers चुनने से अलग defects मिलते हैं।
- Review leader — review की पूरी ज़िम्मेदारी लेता है: तय करता है कि कौन शामिल होगा और आयोजित करता है कि review कब और कहाँ होगा।
Review को सफल क्या बनाता है
- स्पष्ट उद्देश्य और मापने योग्य exit criteria। प्रतिभागियों का मूल्यांकन कभी उद्देश्य नहीं होना चाहिए।
- वर्क प्रोडक्ट और उसके जोखिम के हिसाब से सही review प्रकार — payment rules के लिए inspection, टेक्स्ट बदलाव के लिए informal review।
- छोटे हिस्से। लंबे डॉक्यूमेंट और बड़े diffs पर reviewers का ध्यान टूटता है; काम को बाँटें ताकि हर सत्र केंद्रित रहे।
- Authors और stakeholders को feedback, ताकि प्रोडक्ट और प्रक्रिया दोनों सुधरें।
- तैयारी के लिए पर्याप्त समय, जो schedule में शामिल हो, दूसरे कामों के बीच ठूँसा न जाए।
- Management का दिखता हुआ समर्थन, और review को संगठन की सीखने व सुधारने की संस्कृति का हिस्सा मानना।
- प्रतिभागियों को उनकी भूमिकाओं और review तकनीकों का प्रशिक्षण।
- Facilitated मीटिंग जो findings और फ़ैसले दर्ज करें, कमरे में बैठकर प्रोडक्ट दोबारा डिज़ाइन न करें।
- टिप्पणियाँ काम पर हों, व्यक्ति पर नहीं — जैसे "यह branch expired token को कभी हैंडल नहीं करती", न कि "तुम expired token भूल गए"। Google की code review गाइड भी यही बात कहती है।
व्यावहारिक उदाहरण और review log
उदाहरण के लिए, कोई टीम review प्रकार ऐसे चुन सकती है: दो लाइन के bug-fix pull request का एक साथी द्वारा informal review, CI static checks gate के रूप में; नए release का regression test plan, test lead के नेतृत्व में walkthrough में उन टेस्टरों के सामने जो उसे चलाएँगे; product catalogue API के लिए दो caching रणनीतियों के बीच चुनाव, एक architect, दो senior डेवलपर और एक operations इंजीनियर के साथ moderated technical review में, फ़ैसला दर्ज; और payment फ़ीचर के refund rules, पिछले refund defects से बनी checklist के साथ inspection में।
Review log के लिए किसी ख़ास टूल की ज़रूरत नहीं। नीचे का काल्पनिक उदाहरण वे फ़ील्ड दिखाता है जो findings को traceable और metrics को संभव बनाते हैं।
Log को ऐसे पढ़ें: ऊपर review किया गया डॉक्यूमेंट और उसका version, review का प्रकार (यहाँ inspection), हर भूमिका किसके पास है (author न leader है, न scribe), और entry व exit criteria। फिर हर finding की एक पंक्ति: ID, डॉक्यूमेंट में जगह, finding का प्रकार (अस्पष्टता, छूटी बात, असंगति, testability), severity, finding ख़ुद, owner और status। यहाँ दो major findings हैं — refund की कोई समय-सीमा नहीं, और discount code से चुकाए गए order के आंशिक refund का कोई नियम नहीं — और दो minor: दो sections (4.2 और 6.2) में refund की अलग-अलग सीमा, और ग्राहक को सूचना किस माध्यम से और कितने समय में मिलेगी यह अस्पष्ट। अंत में metrics (पेज, तैयारी और मीटिंग का समय, findings की गिनती) और फ़ैसला: rework ज़रूरी है, और स्वीकार करने से पहले moderator fixes की जाँच करता है।
Review: REQ-PAY-014 Refund rules v0.3 Type: Inspection
Leader: Neha R. Moderator: Omar K. Scribe: Priya S. Author: Arjun M.
Entry: document complete, linked to epic PAY-7, checklist CL-REFUND v2 attached
Exit: no open major findings; every minor finding has an owner
ID Where Type Sev Finding Owner Status
F-01 2.1 Ambiguity Major "Refunds are processed promptly" has no time Arjun Open
limit. State it in business days.
F-02 3.4 Omission Major No rule for a partial refund on an order Arjun Open
paid with a discount code.
F-03 4.2 Consistency Minor Refund limit is 50,000 INR here, 30,000 INR Arjun Fixed
in 6.2.
F-04 AC-7 Testability Minor "The customer is informed": by which channel, Arjun Open
and within what time?
Metrics: 9 pages · preparation 4 h 10 min total · meeting 45 min · 4 findings (2 major)
Decision: rework required; moderator verifies the fixes before acceptanceआज़माएँ: AI टेस्ट केस ऑप्टिमाइज़र आज़माएँ: AI डुप्लिकेट टेस्ट केस डिटेक्टर आज़माएँ: AI टेस्ट कवरेज एनालाइज़र
अक्सर पूछे जाने वाले सवाल
ISTQB में review के चार प्रकार कौन-से हैं?
CTFL v4.0 informal review, walkthrough, technical review और inspection बताता है; informal review सबसे कम औपचारिक है और inspection सबसे ज़्यादा। ये एक जैसी review भूमिकाओं पर निर्भर हैं, पर इसमें अलग हैं कि सामान्य review प्रक्रिया का कितना हिस्सा अपनाते हैं — informal review में कुछ नहीं, inspection में पूरी प्रक्रिया — नेतृत्व कौन करता है, और क्या दर्ज व मापते हैं।
Walkthrough और inspection में क्या फ़र्क़ है?
Walkthrough का नेतृत्व author करता है ताकि वर्क प्रोडक्ट समझा सके, प्रतिभागियों को सिखा सके और सहमति बना सके; तैयारी वैकल्पिक है। Inspection का नेतृत्व ऐसा review leader करता है जो कभी author नहीं होता, individual preparation ज़रूरी है, लक्ष्य जितने हो सकें उतने defects ढूँढना है, और प्रक्रिया सुधारने के लिए metrics इकट्ठा होते हैं।
Pull request review informal है या technical?
ज़्यादातर pull request review informal review हैं: टूल से आगे कोई तय प्रक्रिया नहीं, कोई औपचारिक आउटपुट नहीं। किसी बड़े डिज़ाइन बदलाव वाले pull request को technical review की तरह चलाया जा सकता है — नामित योग्य reviewers, फ़ैसले तक ले जाने वाला moderator, और फ़ैसला दर्ज।
Review का नेतृत्व किसे करना चाहिए?
Walkthrough में author। Technical review में moderator। Inspection में ऐसा review leader जो author न हो; author scribe भी नहीं हो सकता। Review leader review आयोजित करता है, जबकि moderator मीटिंग को प्रभावी और निष्पक्ष रखता है।
Review को कौन-से metrics इकट्ठा करने चाहिए?
Formal review के लिए: वर्क प्रोडक्ट का आकार, preparation और मीटिंग का समय, type और severity के अनुसार findings, finding density, rework effort और बाद में review से छूटे defects। इनका इस्तेमाल checklists और प्रक्रिया सुधारने में करें, व्यक्तियों को आँकने में कभी नहीं।
Management review और audit क्या हैं?
ये IEEE 1028-2008 (अब inactive-reserved) में परिभाषित review प्रकार हैं। Management review प्रगति पर नज़र रखता है और plans, schedules व management approaches का आकलन करता है; audit standards, नियमों, plans या procedures के अनुपालन की स्वतंत्र जाँच है। दोनों में से कोई किसी एक वर्क प्रोडक्ट की तकनीकी सामग्री पर केंद्रित नहीं है।
क्या review asynchronous तरीके से हो सकते हैं?
हाँ। Individual review और communication and analysis का ज़्यादातर हिस्सा review टूल में comments के रूप में हो सकता है। विवादित या फ़ैसला माँगने वाली findings के लिए छोटी मीटिंग या कॉल रखें, और फ़ैसले एक ही जगह दर्ज करें।
संदर्भ
- ISTQB Certified Tester Foundation Level (CTFL) v4.0सॉफ़्टवेयर टेस्टिंग का फ़ाउंडेशन पाठ्यक्रम: टेस्ट स्तर और प्रकार, टेस्ट डिज़ाइन तकनीकें, टेस्ट प्रबंधन और टूल।
- ISO/IEC 20246:2017 — Software and systems engineering — Work product reviewsवर्क प्रोडक्ट की समीक्षा का सामान्य फ़्रेमवर्क — review प्रक्रिया, भूमिकाएँ और review तकनीकें।
- IEEE 1028-2008 — IEEE Standard for Software Reviews and Auditsmanagement review, technical review, inspection, walkthrough और audit की क्लासिक परिभाषाएँ (IEEE इसे inactive-reserved के रूप में सूचीबद्ध करता है)।
- ISTQB Glossaryटेस्टिंग शब्दों की मानक परिभाषाएँ — टेस्ट केस, रिग्रेशन टेस्टिंग, सेवेरिटी, प्रायोरिटी, बाउंड्री वैल्यू एनालिसिस आदि।
- Code Review Developer GuideGoogle की प्रकाशित code review प्रथाएँ: reviewer क्या देखते हैं, बदलाव मंज़ूर करने का मानक और review टिप्पणियाँ कैसे लिखें।
अभ्यास
Review के प्रकार चुनें और inspection plan सुधारें
आप एक काल्पनिक सरकारी e-services पोर्टल की रिलीज़ 3.4 टेस्ट कर रहे हैं, जिसमें commercial licence का ऑनलाइन renewal जुड़ रहा है। इस sprint में पाँच वर्क प्रोडक्ट, W1 से W5, review का इंतज़ार कर रहे हैं, और project manager ने सबसे ज़्यादा जोखिम वाले वर्क प्रोडक्ट के inspection plan का draft लिखा है। नीचे की सामग्री में वर्क प्रोडक्ट, उपलब्ध लोग और draft plan दिए गए हैं।
पहले W1 से W5 में से हर एक के लिए review का प्रकार चुनें, बताएँ कि नेतृत्व कौन करेगा और एक पंक्ति में कारण लिखें; अगर गाइड के चार प्रकारों में से कोई फ़िट न हो, तो बताएँ कि यह किस तरह का review है। फिर draft inspection plan की समस्याएँ लिखें, हर एक के साथ गाइड का वह नियम जो वह तोड़ती है, और plan को सामान्य review प्रक्रिया की पाँच गतिविधियों के क्रम में दोबारा लिखें, छह review भूमिकाएँ सूची के लोगों को देकर। अंत में draft की आख़िरी पंक्ति के नमूना comment को ऐसे दोबारा लिखें कि वह काम के बारे में हो, व्यक्ति के बारे में नहीं।
सरकारी e-services पोर्टल (काल्पनिक) - रिलीज़ 3.4
नया फ़ीचर: commercial licence का ऑनलाइन renewal
इस sprint में review होने वाले वर्क प्रोडक्ट
W1 Pull request: help centre के 40 पेजों पर शब्दों और spelling का सुधार।
सिर्फ़ टेक्स्ट: न logic बदला, न layout।
W2 FR-LIC-07 "Renewal fees" v0.9, 12 पेज। Section 3: licence category के
अनुसार fee। Section 4: renewal में देरी के हर महीने की penalty।
Sections 5 से 7: छूट (exemptions)। मंत्रालय के fee regulation पर आधारित;
एक ग़लत rule नागरिकों से ग़लत रक़म वसूलता है। Author: फ़हद।
W3 उमर का design note: national payment gateway को synchronously call करें,
या asynchronously, callback और retries के साथ। फ़ैसला अगले sprint में
integration का काम शुरू होने से पहले चाहिए।
W4 रिलीज़ 3.4 का regression test plan, प्रिया का लिखा। इसका ज़्यादातर हिस्सा
लीना और यूसुफ़ चलाएँगे।
W5 Steering committee की मासिक मीटिंग: प्रगति की तुलना release schedule से
करना और तय करना कि go-live की तारीख़ अब भी टिकी है या नहीं।
उपलब्ध लोग
सारा project manager
फ़हद business analyst
उमर senior developer
रवि fee service पर काम करने वाला developer
माजिद operations engineer
प्रिया test lead
लीना टेस्टर, पिछले महीने जुड़ी
यूसुफ़ टेस्टर, पिछले महीने जुड़ा
नूरा मंत्रालय के finance विभाग की fee विशेषज्ञ
ख़ालिद दूसरी टीम का QA lead; पहले inspections moderate कर चुका है
W2 का DRAFT INSPECTION PLAN (सारा का लिखा)
Objective: पता लगाना कि हमारी requirements में सबसे ज़्यादा ग़लतियाँ कौन करता है
Review leader: फ़हद (वह rules सबसे अच्छी तरह जानता है)
Moderator: ज़रूरत नहीं
Scribe: फ़हद
Reviewers: उमर और रवि
Document: FR-LIC-07 v0.9; sections 5 से 7 अभी लिखे जा रहे हैं,
मीटिंग से पहले जोड़ दिए जाएँगे
Preparation: कुछ नहीं; मीटिंग में डॉक्यूमेंट साथ पढ़ेंगे
Meeting: 3 घंटे का एक सत्र: सभी 12 पेज देखना और हर समस्या का fix तय करना
Exit: मीटिंग ख़त्म हो गई
Follow-up: फ़हद वे findings ठीक करेगा जिनसे वह सहमत है
Metrics: हर author की findings की गिनती, सालाना appraisal के लिए
Tone: पिछली बार की तरह सीधी बात: "फ़हद फिर से maximum penalty भूल गया।"- W1 से W4 में से हर एक के लिए दो सवाल पूछें: छूटा defect कितना महँगा पड़ेगा, और review मुख्य रूप से किसलिए है — anomalies जल्दी ढूँढना, समझ बनाना, कोई तकनीकी फ़ैसला लेना, या जितनी हो सकें उतनी anomalies ढूँढना? जवाबों से प्रकार और उसका leader चुनें।
- गाइड की शुरुआत वाले वर्गीकरण की मदद से तय करें कि W5 किसी वर्क प्रोडक्ट की सामग्री की जाँच करता भी है या नहीं।
- Draft inspection plan को पंक्ति-दर-पंक्ति inspection की विशेषताओं, छह भूमिकाओं और सफलता के कारकों से मिलाकर पढ़ें। हर समस्या के आगे वह नियम लिखें जो वह तोड़ती है।
- छह भूमिकाएँ सूची के लोगों को दें, यह ध्यान रखते हुए कि inspection में कौन कौन-सी भूमिका नहीं ले सकता, और ऐसे entry और exit criteria लिखें जिनमें से हर एक का जवाब हाँ या ना में हो।
- सुधरे हुए plan को गतिविधियों के क्रम में रखें — Planning, Review initiation, Individual review, Communication and analysis, Fixing and reporting — इकट्ठा किए जाने वाले metrics और दोबारा लिखे गए comment समेत।
मॉडल उत्तर दिखाएँ
W1 — informal review। एक साथी pull request पढ़ता है और review टूल में comments लिखता है; किसी के नेतृत्व की ज़रूरत नहीं, और कोई औपचारिक आउटपुट ज़रूरी नहीं। Help पेज पर ग़लत शब्द ठीक करना सस्ता है, और गाइड टेक्स्ट बदलाव को informal review का आम उदाहरण बताती है। 40 पेज ज़्यादा औपचारिकता का कारण नहीं हैं: वे pull request को कुछ छोटे pull requests में बाँटने का कारण हैं ताकि reviewer का ध्यान बना रहे (छोटे हिस्से), और यांत्रिक हिस्सा टीम के automated spelling या link checks पर, अगर हों, छोड़ने का।
W2 — inspection, जिसका नेतृत्व ऐसा review leader करे जो author फ़हद न हो। ये rules तय करते हैं कि नागरिक कितना भुगतान करेंगे और एक regulation से निकले हैं, इसलिए छूटा defect go-live के बाद ठीक करना महँगा पड़ता है; payment calculation rules और नियामक requirements ठीक वही वर्क प्रोडक्ट हैं जिनके लिए गाइड inspection रखने को कहती है। Inspection पूरी सामान्य review प्रक्रिया का पालन करता है: entry और exit criteria, checklist के साथ individual preparation, moderator द्वारा चलाई गई मीटिंग, औपचारिक rework और उसके पूरा होने की जाँच, और metrics।
W3 — technical review, जिसका नेतृत्व moderator (जैसे ख़ालिद) करे, तकनीकी रूप से योग्य reviewers के साथ: रवि, जो integration बनाएगा; operations की ओर से माजिद; और प्रिया जैसा कोई टेस्टर, जो पूछे कि gateway timeout, retry या duplicate callback कैसे टेस्ट होंगे। उमर author के रूप में शामिल होता है। Reviewers individual preparation करते हैं, और फ़ैसला उसके कारणों के साथ दर्ज होता है। मुख्य उद्देश्य किसी तकनीकी समस्या पर सहमति और फ़ैसला है, और technical review इसी के लिए है; moderator पक्का करता है कि चर्चा अगले sprint में integration का काम शुरू होने से पहले फ़ैसले पर ख़त्म हो।
W4 — walkthrough, जिसका नेतृत्व author प्रिया करती है। वह लीना, यूसुफ़ और हो सके तो एक developer को plan से गुज़ारती है, एक-दो test scenarios को dry run की तरह चलाकर। मुख्य उद्देश्य समझ बनाना और सिखाना है: plan चलाने वाले जानें कि हर टेस्ट क्यों है और उस पर सवाल उठा सकें। तैयारी वैकल्पिक है। क्योंकि author कहानी पर नियंत्रण रखता है, किसी एक प्रतिभागी — जैसे developer — से कहें कि वह "अगर ऐसा हो तो…?" पूछता रहे।
W5 — चारों में से कोई प्रकार नहीं। जो मीटिंग प्रगति पर नज़र रखती है और जाँचती है कि schedule टिका है या नहीं, उसे IEEE 1028-2008 management review कहता है। इसे management चलाता है: सारा project की स्थिति बताती है और steering committee go-live का फ़ैसला लेती है। इसका मुख्य काम किसी वर्क प्रोडक्ट की तकनीकी सामग्री में defects ढूँढना नहीं है, इसलिए इसे inspection या walkthrough की तरह नहीं चलाना चाहिए। टेस्ट टीम इसे test progress और खुले risks की जानकारी देती है।
Draft plan की समस्याएँ: (1) Objective, यानी यह पता लगाना कि सबसे ज़्यादा ग़लतियाँ कौन करता है, लोगों का मूल्यांकन है; प्रतिभागियों का मूल्यांकन कभी review का उद्देश्य नहीं होना चाहिए। Inspection का मुख्य उद्देश्य जितनी हो सकें उतनी anomalies ढूँढना है, यहाँ fee service बनने से पहले FR-LIC-07 में। (2) Author फ़हद review leader है, और (3) scribe भी: inspection में author इनमें से कोई भूमिका नहीं ले सकता। (4) कोई moderator नहीं, जबकि inspection मीटिंग moderator चलाता है ताकि findings दर्ज हों, समय का पालन हो और हर कोई खुलकर बोल सके। (5) उमर और रवि दोनों developer हैं और एक ही दृष्टिकोण लाते हैं: कोई rules को regulation से नहीं मिलाता (नूरा), और कोई नहीं पूछता कि हर rule टेस्ट हो सकता है या नहीं (कोई टेस्टर)। (6) Sections 5 से 7 अभी हैं ही नहीं, इसलिए डॉक्यूमेंट inspect करने लायक पूरा नहीं है, और मीटिंग में पहुँचने वाले टेक्स्ट पर कोई तैयारी नहीं कर सकता। (7) न individual preparation है न checklist, जबकि inspection में दोनों ज़रूरी हैं।
(8) सभी 12 पेजों पर 3 घंटे का एक सत्र छोटे हिस्सों वाले कारक की अनदेखी है: लंबे सत्रों में reviewers का ध्यान टूटता है। (9) मीटिंग में हर समस्या का fix तय करना उसे redesign में बदल देता है; मीटिंग findings दर्ज करती है और उनका status, owner और action तय करती है, और author बाद में उन्हें ठीक करता है। (10) "मीटिंग ख़त्म हो गई" मापने योग्य exit criterion नहीं है: यह डॉक्यूमेंट की क्वालिटी के बारे में कुछ नहीं कहता। (11) "फ़हद वे findings ठीक करेगा जिनसे वह सहमत है" हर finding पर समूह के फ़ैसले की जगह author का फ़ैसला रख देता है, और rework की जाँच कोई नहीं करता, जबकि inspection में औपचारिक rework और उसके पूरा होने की जाँच ज़रूरी है। (12) सालाना appraisal के लिए हर author की findings: inspection metrics प्रक्रिया सुधारने के लिए हैं, author या reviewers को आँकने के लिए कभी नहीं। (13) नमूना comment व्यक्ति के बारे में है ("फ़हद फिर से… भूल गया"), काम के बारे में नहीं। इनमें से दस या ज़्यादा समस्याएँ ढूँढना पूरा जवाब है।
सुधरे हुए plan में भूमिकाएँ (दूसरे विकल्प भी ठीक हैं, बशर्ते author न review leader हो न scribe, हर भूमिका भरी हो, और reviewers के दृष्टिकोण अलग हों): Manager — सारा, जो तय करती है कि W2 का inspection होगा और sprint में preparation व मीटिंग का समय रखती है; Review leader — प्रिया, जो पूरी ज़िम्मेदारी लेती है, प्रतिभागी चुनती है और तय करती है कि review कब और कहाँ होगा; Moderator — ख़ालिद, जो पहले inspections moderate कर चुका है; Scribe — लीना; Author — फ़हद, जो सवालों के जवाब देता है और rework करता है; Reviewers — नूरा (क्या हर rule regulation से मेल खाता है?), रवि (क्या हर rule ठीक-ठीक implement हो सकता है, rounding और तारीख़ों समेत?) और यूसुफ़ (क्या कोई टेस्ट दिखा सकता है कि हर rule पूरा होता है?)।
Planning (प्रिया, सारा के साथ): उद्देश्य — implementation से पहले FR-LIC-07 में जितनी हो सकें उतनी anomalies ढूँढना; scope — पूरा डॉक्यूमेंट; आँकी जाने वाली क्वालिटी विशेषताएँ — regulation के हिसाब से सही होना, पूर्णता, संगति और testability; ध्यान के क्षेत्र — ऊपर reviewers की सूची के अनुसार; सहायक जानकारी — fee regulation और एक checklist; effort और समय-सीमा — हर reviewer के लिए preparation time और दो मीटिंग, sprint में शामिल। Entry criteria: FR-LIC-07 पूरा, sections 5 से 7 समेत, किसी नए version जैसे v1.0 में; regulation और checklist साथ में; हर प्रतिभागी के पास डॉक्यूमेंट की पहुँच और अपनी भूमिका की जानकारी। Exit criteria: हर finding type, severity, owner और status के साथ दर्ज; कोई open major finding नहीं; हर minor finding का owner है; moderator ने rework की जाँच कर ली है। अगर टीम sections 5 से 7 का इंतज़ार नहीं कर सकती, तो sections 1 से 4 का inspection अभी करें और sections 5 से 7 का दूसरा inspection उनके लिखे जाने के बाद।
Review initiation: प्रिया entry criteria जाँचती है, डॉक्यूमेंट, regulation और checklist भेजती है, और लीना व यूसुफ़ को उनकी भूमिकाएँ समझाती है, क्योंकि यह उनका पहला inspection है। Fee rules के लिए उपयोगी checklist: हर रक़म की currency और rounding rule हो; हर penalty बताए कि वह किस दिन से गिनी जाती है और क्या कुल penalty की कोई अधिकतम सीमा है; हर छूट बताए कि वह किसे मिलती है और कौन-सा प्रमाण चाहिए; कोई rule किसी दूसरे section से टकराए नहीं; हर rule किसी टेस्ट से जाँचा जा सके। इसमें वे defects भी जोड़ें जो टीम पहले fee rules में पा चुकी है। Individual review: हर reviewer मीटिंग से पहले अकेले काम करता है, checklist और कुछ scenarios के साथ — expiry के एक दिन बाद renew हुआ licence, चौदह महीने देर से हुआ renewal, छूट वाला प्रतिष्ठान जो देर से renew भी करता है — और anomalies, सुझाव व सवाल दर्ज करता है।
Communication and analysis: एक की जगह moderator द्वारा चलाए गए दो सत्र — पहले sections 1 से 4, फिर sections 5 से 7। ख़ालिद चर्चा को findings समझने और दर्ज करने पर रखता है, fixes डिज़ाइन करने पर नहीं; लीना हर finding को review log में ID, जगह, type (अस्पष्टता, छूटी बात, असंगति, testability), severity, owner और status के साथ दर्ज करती है; हर finding के लिए समूह status, owner और action तय करता है, और अंत में डॉक्यूमेंट का क्वालिटी स्तर: स्वीकार, rework, या rework और दूसरा inspection। Fixing and reporting: फ़हद डॉक्यूमेंट पर rework करता है; जिन findings पर सुधार चाहिए वे defect reports या ट्रैक किए जाने वाले items बनती हैं; ख़ालिद log से मिलाकर rework जाँचता है; exit criteria पूरे होने पर डॉक्यूमेंट स्वीकार होता है और प्रिया नतीजे सारा और टीम को रिपोर्ट करती है।
Metrics: आकार (inspect किए गए पेजों की संख्या), हर reviewer का preparation time, मीटिंग का समय, type और severity के अनुसार findings, प्रति पेज findings, rework effort, और बाद में fee rules के वे defects जो testing या production में मिले और inspection से छूट गए। इनका इस्तेमाल checklist और प्रक्रिया सुधारने में करें, फ़हद या reviewers को आँकने में कभी नहीं। काम के बारे में दोबारा लिखा गया comment: "Section 4 देरी के हर महीने की penalty तय करता है, पर यह नहीं बताता कि कुल penalty की कोई अधिकतम सीमा है या नहीं। अधिकतम सीमा और regulation का वह article लिखें जिससे वह आती है, या लिखें कि कोई सीमा नहीं है।" इसे omission (छूटी बात) के रूप में major severity के साथ दर्ज करें, क्योंकि इससे नागरिकों का भुगतान बदल सकता है।
अपना काम जाँचें: नाम और शब्द अलग हो सकते हैं। आपका जवाब पूरा है अगर W2 inspection है और W5 चारों प्रकारों में से नहीं है; W2 का author न review leader है न scribe; moderator है; reviewers regulation, implementation और testing तीनों को कवर करते हैं; preparation individual है और checklist के साथ है; entry criteria पूरा डॉक्यूमेंट माँगते हैं; हर exit criterion का जवाब हाँ या ना में है; मीटिंग redesign के बजाय findings दर्ज करती है; rework की जाँच author के अलावा कोई और करता है; और किसी metric का इस्तेमाल किसी व्यक्ति को आँकने में नहीं होता।
इस topic में आपकी प्रगति
प्रगति ट्रैक करने के लिए साइन इन करें
Topics पूर्ण चिह्नित करें, जहाँ छोड़ा था वहीं से जारी रखें और specialisation परीक्षाएँ खोलें।
QA रोडमैप का हिस्सा
इस topic से पहले
इस गाइड में बताए गए टूल्स
requirements में अस्पष्ट, धुँधले या परस्पर विरोधी कथन पकड़ें और Mutqan AI से स्पष्टीकरण के सवाल पाएँ।
acceptance criteria की testability, पूर्णता और अस्पष्टता की समीक्षा करें और Mutqan AI से बेहतर लिखे गए सुझाव पाएँ।
Mutqan AI से मौजूदा टेस्ट केस बेहतर बनाएँ: साफ़ स्टेप, सटीक अपेक्षित परिणाम, छूटी हुई पूर्व-शर्तें और बेहतर संरचना।
Mutqan AI से किसी सूट में डुप्लिकेट और आपस में ओवरलैप करते टेस्ट केस खोजें और मर्ज करने की सिफ़ारिशें पाएँ।
Mutqan AI से requirements या किसी user story की तुलना मौजूदा टेस्ट केस से करके अनटेस्टेड हिस्से खोजें।
OpenAPI contract में डिज़ाइन जोखिम जाँचें: असंगत naming, छूटे error responses, कमज़ोर auth, breaking-change ख़तरे, pagination और validation की कमियाँ।
दो टेक्स्ट की लाइन-दर-लाइन या शब्द-दर-शब्द तुलना करें और अंतर हाइलाइट करें।