यदि सुपरफ्लूओस टिप्पणी देखने से आपके रक्तचाप में वृद्धि होती है, तो आपको पीने या कुछ लेने की आवश्यकता होती है।
उसने कहा, मैं मानता हूं कि ऐसी टिप्पणियां अधिकतर बेकार हैं। यदि लगातार उपयोग किया जाता है, तो कार्यक्रम जल्द ही ऐसी टिप्पणियों का एक भूलभुलैया बन जाएगा। क्या होगा यदि संस्करण 2.5 के लिए एक बार एक पंक्ति बदल दी गई है और फिर एक साल बाद बग 32 9 4 के लिए फिर से बदल दिया गया? क्या आप एक ही पंक्ति पर दो "संस्करण" टिप्पणियां डालते हैं, या बस नवीनतम रखते हैं? यदि आप केवल नवीनतम रखते हैं, तो आप इस तथ्य को खो चुके हैं कि यह मूल रूप से 2.5 के लिए जोड़ा गया था। यदि आप उन्हें दोनों रखते हैं, तो तीसरा परिवर्तन या चौथा होने पर क्या होता है? हम कैसे जानते हैं कि प्रत्येक परिवर्तन पर राज्य क्या था? क्या होता है जब आप संस्करण 2.5 में कोड का एक ब्लॉक जोड़ते हैं, और उसके बाद संस्करण 2.6 के लिए आप 2.5 ब्लॉक के भीतर एम्बेडेड कोड का एक और ब्लॉक जोड़ते हैं? आदि आदि। कार्यक्रम कोड की रेखाओं की तुलना में अधिक संस्करण टिप्पणियां आसानी से समाप्त हो सकता है।
यदि लगातार नहीं किया जाता है, तो टिप्पणियां जल्दी से भ्रामक हो जाएंगी। कोई टिप्पणी कर सकता है कि यह ब्लॉक 2.5 के लिए जोड़ा गया था, कोई और संस्करण 2.6 के लिए उस ब्लॉक के अंदर कोड डाल सकता है और टिप्पणी नहीं कर सकता है, और अब हमारे पास एक टिप्पणी है जो कहती है कि दूसरा ब्लॉक 2.5 के लिए जोड़ा गया था।
और क्या हमें इतना परवाह है? यह बहुत दुर्लभ है कि जब कोई परिवर्तन किया गया तो मुझे परवाह है। ओह, ठीक है कुछ हफ्ते पहले मैंने परवाह की क्योंकि मैं जानना चाहता था कि एक बड़े स्क्रू के लिए दोषी कौन है।
जैसा कि अन्य ने बताया है, संस्करण नियंत्रण प्रणाली दुर्लभ मौकों पर आपके लिए यह करते हैं जब आपको इसकी आवश्यकता होती है। मुझे लगता है कि अगर आपके पास वीसीएस का कोई प्रकार नहीं है, तो ऐसा करने के लिए एक मामला बनाया जा सकता है। लेकिन आप मुफ्त में कुछ बहुत अच्छे वीसीएस प्राप्त कर सकते हैं। यदि आपको एक की जरूरत है, तो एक प्राप्त करें। अन्यथा आप उन लोगों की तरह हैं जो कहते हैं कि आपको अपने सिर में अंकगणित करना चाहिए क्योंकि अन्यथा आप क्या करेंगे यदि आपका कैलकुलेटर काम करना छोड़ देता है। धारणा जाहिर है कि किसी भी पल में, दुनिया के सभी कैलकुलेटर एक साथ टूट सकते हैं।
आप कह सकते हैं कि यह कहने में सक्षम हो सकता है, "ओह, यह नए विक्रेता टाइमकार्ड फ़ंक्शन का समर्थन करने के लिए प्रविष्टि के क्रम में जोड़ा गया था" या कुछ ऐसे। लेकिन फिर यह महत्वपूर्ण नहीं है कि "यह कोड बॉब द्वारा संस्करण 3.2.4 के लिए बदला गया था", बल्कि, "यह कोड इस डेटा का उत्पादन करता है जिसका उपयोग यहां नहीं किया जाता है लेकिन वहां पर किसी अन्य मॉड्यूल द्वारा इसकी आवश्यकता होती है"।
मैं टिप्पणियों को लिखने में दृढ़ आस्तिक हूं जो कोड के अनुभाग पेश करते हैं और जटिल या अन्यथा गैर-स्पष्ट कोड के पीछे सामान्य विचार का वर्णन करते हैं। लेकिन यह एक पूरी तरह से अलग बात है।
मैं इस अभ्यास के अपने नापसंद को साझा करता हूं। मुझे लगता है कि यह संस्करण नियंत्रण उपकरण की क्षमताओं की गलतफहमी का प्रदर्शन करता है। मैंने हमेशा अपराधियों को धीरे-धीरे शिक्षित करने की कोशिश की। मेरे पास कोड में जांच करने वाले लोगों के साथ समान समस्या है जिसमें कोड पर टिप्पणी शामिल है। –
मेरी समस्या यह है कि दोनों प्रथाओं (दोष संख्या टिप्पणियां, और बाद में उपयोग के लिए कोड को टिप्पणी करना) विकल्प के मुकाबले उपयोग करना बहुत आसान है।मुझे लगता है कि कोड को टिप्पणी करना बहुत बुरी समस्या है, क्योंकि यह चारों ओर पूरी तरह से मृत detritus छोड़ देता है। मुझे दोष जोड़ने वाली टिप्पणियां पसंद हैं, क्योंकि वे परिवर्तन के बारे में और अधिक चर्चा करने के लिए त्वरित शॉर्ट-कट प्रदान करते हैं। –
वे यह भी संकेत देते हैं कि कोड के उस अनुभाग को लोगों के एक बड़े समूह के बारे में सोचा गया है और यह अंतिम परिणाम है, इसलिए कार्यात्मक परिवर्तन करने के बारे में अधिक सावधान रहें। –