बैज दिखाना सस्ता और समझना महँगा है। प्रकाशित ऑडिट रिपोर्ट अभियांत्रिकी काम का एक सीमित टुकड़ा है: एक नामित मूल्यांकनकर्ता ने नामित घटकों को, नामित संस्करण पर, घोषित विधि और समय-बजट के साथ जाँचा। ये चार तथ्य तय करते हैं कि निष्कर्ष किस बात का समर्थन कर सकता है, और ये आम तौर पर पहले कुछ पृष्ठों में होते हैं, मार्केटिंग सारांश में नहीं। इन्हें पढ़ने में दस मिनट लगते हैं और क्लाइंट ऐप के निष्कर्ष को पूरी सेवा तक बढ़ा देने की आम गलती रुकती है।

दायरा अनुभाग वास्तव में क्या सीमित करता है

दायरे का वक्तव्य एक बाड़ है, और उसके बाहर का सब कुछ उत्तरहीन रहता है, पास नहीं। रिपोर्टें जाँचे गए घटक, कमिट सीमा या बिल्ड पहचानकर्ता, इस्तेमाल किया गया वातावरण और अनुमत अंतःक्रिया मॉडल सूचीबद्ध करती हैं। डेस्कटॉप क्लाइंट, मोबाइल ऐप, सर्वर कोड, खाता बैकएंड और उत्पादन अवसंरचना पाँच अलग विषय हैं, और एक कार्य उनमें से कोई भी उपसमुच्चय कवर कर सकता है।

बहिष्करण उतने ही महत्त्वपूर्ण हैं जितने समावेशन, क्योंकि वे जानबूझकर बताए जाते हैं और लापरवाही से पढ़े जाते हैं। दायरे से बाहर बताई गई खाता प्रणाली को निहित रूप से सुरक्षित नहीं माना जाता, और कार्य से बाहर छोड़ा गया मोबाइल ऐप बस अपरीक्षित है। अपने नोट्स में हर अपरीक्षित घटक को अज्ञात के रूप में चिह्नित करें, और खाली जगह को प्रतिष्ठा से भरने के लोभ का सामना करें।

दो तरह की जाँच अलग प्रश्नों का उत्तर देती हैं

स्रोत समीक्षा और रनटाइम परीक्षण अलग-अलग विफलताएँ खोजते हैं। कोड पढ़ने वाला समीक्षक कुंजी-व्युत्पत्ति का पीछा कर सकता है, छूटी हुई लंबाई-जाँच पकड़ सकता है और पूरे पार्सर के बारे में उसे चलाए बिना तर्क कर सकता है। चलती सेवा के सामने परीक्षक पाता है कि तैनात बिल्ड वास्तव में क्या करता है: ऐसा प्रमाणपत्र जिसे ऐप अस्वीकार करता है, अब भी सक्षम फ़ॉलबैक प्रोटोकॉल, ऐसा एंडपॉइंट जो किसी की समीक्षा न की गई कॉन्फ़िगरेशन से संस्करण बैनर लीक करता है।

कोई भी दूसरे का विकल्प नहीं है, और रिपोर्ट आम तौर पर बताती है कि कौन-सी की गई। जब सारांश इस भेद के बिना «ऑडिट किया गया» कहता है, तो अस्पष्टता सारांश में है, रिपोर्ट में नहीं।

पहुँच सीमाएँ वही काम करती हैं। ब्लैक-बॉक्स कार्य सर्वर कॉन्फ़िगरेशन नहीं देख सकता, और जो आर्किटेक्चर समीक्षा कभी तैनात एंडपॉइंट को नहीं छूती वह नहीं देख सकती कि उत्पादन आरेख से भिन्न है। दोनों वैध हैं; उनके परिणामों को मिलाना नहीं।

कोई निष्कर्ष सुधरा हुआ संस्करण कैसे बनता है

रिपोर्ट का मूल्यवान आधा भाग उपचार तालिका है: हर निष्कर्ष, मूल्यांकनकर्ता की विधि के अनुसार उसकी गंभीरता, ऑपरेटर की प्रतिक्रिया और पुनःपरीक्षण का परिणाम। गंभीरता के अंक प्रकृति से नहीं, चुनी गई कार्यप्रणाली से आते हैं, इसलिए गंभीरता की तुलना एक ही रिपोर्ट के भीतर करें, अलग पैमानों वाली दो रिपोर्टों के बीच नहीं।

फिर सुधार को जारी सॉफ़्टवेयर से जोड़ें। सुधरा हुआ निष्कर्ष उपयोगकर्ता के लिए तभी मायने रखता है जब सुधार वाला संस्करण ही स्थापित हो, इसीलिए रिपोर्ट के बिल्ड पहचानकर्ता और रिलीज़ के परिवर्तन-लॉग को साथ पढ़ना पड़ता है। सुधार को कवर करने वाला पुनःपरीक्षण चक्र बंद करता है; अपरीक्षित सुधार एक दावा है। वैसा ही वह सुधार भी है जो केवल ऐसी शाखा में भेजा गया जिसे किसी स्थिर रिलीज़ ने कभी विलीन नहीं किया।

बैज आपको क्या नहीं बता सकता

निष्कर्षों का अभाव दोषों के अभाव का प्रमाण नहीं है। निश्चित बजट वाला छोटा कार्य कुछ चूक जाएगा, और स्वच्छ रिपोर्ट का ईमानदार पाठ यह है कि मूल्यांकनकर्ता को उपलब्ध समय में वे समस्या-वर्ग नहीं मिले जिन्हें वह खोज रहा था।

बैज यह भी अपने दायरे से बाहर के गुणों के बारे में नहीं बोल सकता. लॉगिंग पद्धति, अधिकारक्षेत्र या प्रतिधारण के दावे नीति दस्तावेज़ में रहते हैं, क्लाइंट एप्लिकेशन के ऑडिट में नहीं, और मूल्यांकनकर्ता की कोई प्रतिष्ठा उस सीमा को पार नहीं करती।

ऐसे प्रमाण दर्ज करना जिनका आप बचाव कर सकें

उद्धरण तीन भागों में लिखें: घटक, संस्करण और सत्यापित सुधार। प्रकाशित कार्य जैसे Mozilla द्वारा मँगाया गया VPN ऑडिट ठीक उन्हीं कथनों का समर्थन करता है जो उसका दायरा बताता है और उससे अधिक कुछ नहीं, जो उद्धरण सटीक होने पर अब भी काफ़ी मूल्यवान है। वही रिपोर्ट जिसने कभी जाँचा ही नहीं, उसके लिए उद्धृत की जाए तो किसी उद्धरण के न होने से कम मूल्यवान है, क्योंकि वह ऐसा भरोसा आमंत्रित करती है जो किसी ने कमाया नहीं।

जब दावा किया गया गुण हर उपलब्ध रिपोर्ट से बाहर पड़े, तो उसे दस्तावेज़ में अनसुलझा छोड़ दें। अनसुलझी पंक्ति अनुवर्ती प्रश्न आमंत्रित करती है; बैज नहीं। एकमात्र अपवाद वह गुण है जिसे कोई दूसरा, उतना ही विशिष्ट दस्तावेज़ तय करता है, और तब दावा नहीं, उद्धरण बदलता है।

दो और आदतें पढ़ने को टिकाऊ बनाती हैं: जो रिलीज़ आप वास्तव में चलाते हैं उसके सामने रिपोर्ट की तारीख लिखें, और जो जाँचा गया तथा जो आपने तैनात किया उसका अंतर रखें। दोनों भरोसे के निर्णय को ऐसी चीज़ में बदल देते हैं जिसे सहकर्मी जाँच सके।

संबंधित लेख