कोड में आत्म-अभिव्यक्ति के तरीके के रूप में टिप्पणियाँ

हाल ही में, एक नहीं बहुत लोकप्रिय रूपरेखा उठाते हुए, मैं निम्नलिखित कोड कोड में आया।


क्योंकि हत्यारा रोबोट गेंडा प्यार करता है!

मुझे नहीं पता कि लेखक ने क्या सोचा और किस मूड में व्यक्त करना चाहता था, लेकिन इसने मुझे यह सोचने के लिए प्रेरित किया: हम कितनी बार टिप्पणियों का उपयोग उनके इच्छित उद्देश्य के लिए नहीं करते हैं? कुछ कटौती के तहत पाता है।

  // अगर आपको मंगलवार के दिन शुक्रवार की पोस्ट पसंद नहीं है तो इसे पढ़ने की सिफारिश नहीं की जाती है। 

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

दु: खद स्वीकारोक्ति

क्या आपने कभी कुछ लिखा है जिसके लिए आप खुद से नफरत करते थे? क्या आप समझते हैं कि ऐसा करना बुरा और बदसूरत है, लेकिन हालात (उदाहरण के लिए ग्राहक की आवश्यकताएं) आपसे ज्यादा मजबूत थे? ऐसा ही कुछ हुआ।

  // यह कोड बेकार है, आप इसे जानते हैं और मैं इसे जानता हूं।
 // आगे बढ़ें और मुझे बाद में एक बेवकूफ कहें। 

यह कोड घृणित है, आप इसे जानते हैं और मैं इसे जानता हूं। आगे बढ़ते हैं, फिर मुझे एक बेवकूफ कहते हैं।

  // मैं इस कोड के लिए जिम्मेदार नहीं हूं।
 // उन्होंने मुझे अपनी इच्छा के विरुद्ध लिखा। 

मैं इस कोड के लिए ज़िम्मेदार नहीं हूं। मुझे अपनी इच्छा के विरुद्ध यह लिखने के लिए मजबूर किया गया।

  // मुझे एक बेहतर नौकरी ढूंढनी है 

यह एक बेहतर नौकरी खोजने का समय है

  // मैं यह सारा कोड, अपना सारा काम, अपनी पत्नी डार्लीन को समर्पित कर दूंगा, जो करेगी 
 // मुझे और हमारे तीन बच्चों और कुत्ते को एक बार सहारा देना है 
 // जनता में जारी। 

मैं यह सब कोड, अपना सारा काम, अपनी पत्नी डार्लीन को समर्पित करता हूं, जिसे दिन की रोशनी देखते ही मुझे अपने तीन बच्चों और कुत्ते की देखभाल करनी होगी।

और कभी-कभी कोड लिखने के लिए कॉर्पोरेट मानक आपको कुछ ऐसा करने के लिए मजबूर करते हैं जो डेवलपर के आंतरिक तर्क के लिए खुद को उधार नहीं देता है।

  const int TEN = 10;  // मानो 10 के मूल्य में उतार-चढ़ाव होगा ... 

मानो मान 10 भिन्न हो सकते हैं ...

मुझे उस मामले की याद आई जब मुझे फ्रीलांस पर एक निर्देशिका पर एक छोटा सा काम मिला था। इंटरैक्शन सिस्टम एक जटिल तरीके से बनाया गया था, जिसके परिणामस्वरूप ग्राहक से कोई प्रत्यक्ष प्रतिक्रिया नहीं थी। और "चित्र के रूप में करना आवश्यक था, क्योंकि ग्राहक को इतना ही मंजूर था", हालांकि यह कोड के दृष्टिकोण से बदसूरत था। क्या आपको भी ये पता चला है?

चेतावनी और खोया ज्ञान

ऐसा होता है कि कुछ कोड के साथ हस्तक्षेप नहीं करना बेहतर है। इसे सुधारने, अनुकूलन करने या अन्यथा सुधारने की कोशिश न करें।

 / * * आप सोच सकते हैं कि आपको पता है कि निम्नलिखित कोड क्या करता है।  * लेकिन तुम नहीं।  मुझ पर भरोसा रखो।  * इसके साथ फिडेल, और आप बहुत से नींद में बिताएंगे * रात को उस पल को कोसते हुए जब आपको लगा कि आप चतुर हैं * नीचे दिए गए कोड को "अनुकूलित" करने के लिए पर्याप्त है।  * अब इस फाइल को बंद करें और किसी अन्य चीज से खेलें।  * / 

यह आपको लग सकता है कि आपको पता है कि बाद में कोड क्या करता है। ऐसा नहीं है। मुझ पर भरोसा रखो। इसे प्राप्त करें, और आप उस पल को कोसते हुए कई रातों को बिताएंगे जब आपको लगा कि आप इसे "अनुकूलित" करने के लिए पर्याप्त स्मार्ट थे। अब इस फ़ाइल को बंद करें और कुछ और के साथ खेलें।

  / *
  * प्रिय रखवाले
  *
  * एक बार जब आप इस दिनचर्या को 'अनुकूलित' करने की कोशिश कर रहे हैं,
  * और आपने महसूस किया है कि कौन सी भयानक गलती थी,
  * कृपया चेतावनी के रूप में निम्नलिखित काउंटर बढ़ाएँ
  * अगले आदमी को।
  *
  * Total_hours_wasted_here = 73
  * / 

प्रिय सम्मोहक व्यक्ति! जब आपने इस प्रक्रिया को "ऑप्टिमाइज़" करने का अपना प्रयास पूरा कर लिया है और महसूस किया है कि यह त्रुटि कितनी राक्षसी थी, तो आपके लिए आने वाले लोगों के लिए चेतावनी के रूप में बाद के काउंटर को बढ़ाएं।

  // जादू।  छूना मत। 

जादू है। छूना मत।

  / *
 गूगल के ठुमके पर सलाह देने के घंटों के बाद
 मुझे पता चला है कि अज्ञात बलों की इच्छा से
 नीचे की रेखा के बिना, IE7 का मानना ​​है कि 6px = 12px
 * /
 फ़ॉन्ट-आकार: 0px; 

घंटों परामर्श और गुगली करने के बाद, मैंने पाया कि अज्ञात बलों की इच्छा के बिना, बाद की पंक्ति में IE7 का मानना ​​है कि 6px = 12px

  // ऑटोजेनरेटेड, संपादित न करें।  सभी परिवर्तन पूर्ववत होंगे। 

स्वचालित रूप से उत्पन्न, संपादित न करें। सभी परिवर्तनों को छोड़ दिया जाएगा।

वैसे, आपके कोड में आने के प्रयासों के खिलाफ लड़ाई में स्मार्टनेस का एक दिलचस्प उदाहरण है। वे कहते हैं कि यह काम करता है।

दर्द और निराशा

क्या आपको किसी ऐसी चीज़ के साथ काम करना पड़ा जिससे आप पूरी तरह निराशा में थे? Xee छवि दर्शक के डेवलपर को PSD प्रारूप को पार्स करने का सामना करना पड़ा है। लेकिन एक प्रोग्रामर किसके साथ अपनी पीड़ा साझा कर सकता है, यदि टिप्पणी नहीं है? नीचे एक अनुवाद है, मूल वर्तमान में गितुब पर है ।

यहां मैं एक पल के लिए रुकना चाहूंगा और एडोब पीएसडी प्रारूप के बारे में बात करूंगा। PSD एक अच्छा प्रारूप नहीं है। PSD एक बुरा प्रारूप भी नहीं है। इसे कॉल करने के लिए जो अन्य खराब प्रारूपों, जैसे पीसीएक्स या जेपीईजी का अपमान होगा। नहीं, PSD एक राक्षसी प्रारूप है। इस कोड पर काम करने के कुछ हफ़्ते ने PSD की मेरी नफरत को एक भयंकर आग के स्तर तक बढ़ा दिया, जो एक लाख सूर्यों के भयंकर जुनून के साथ जल रहा था।

अगर कुछ करने के दो तरीके हैं, तो PSD दोनों अलग-अलग जगहों पर उपयोग करता है। इसके अलावा, वह तीन और तरीके बनाएगा जो किसी भी समझदार व्यक्ति को नहीं हुए होंगे, और एक ही समय में उनका उपयोग करेंगे। PSD कला के स्तर पर असंगति लेता है। उदाहरण के लिए, उन्होंने फैसला किया कि इन ब्लॉकों को चार बाइट्स द्वारा संरेखित किया जाना चाहिए, और इस संरेखण को आकार में शामिल नहीं किया जाना चाहिए? अन्य स्थानों के अन्य ब्लॉक या तो संरेखित नहीं करते हैं या आकार में संरेखण शामिल करते हैं। यहाँ, हालाँकि, यह शामिल नहीं है। इन तीन तरीकों में से कोई भी करना होगा। एक उचित प्रारूप एक पर केंद्रित होगा। PSD, निश्चित रूप से, तीनों और अन्य का उपयोग करता है।

एक PSD फ़ाइल से डेटा निकालने की कोशिश करना आपके विलक्षण पुराने चाचा के अटारी में कुछ तलाशने जैसा है जो अपने 58 वें जन्मदिन पर एक उन्मादी ताजे पानी के शार्क के हमले से मर गए थे। अंतिम विवरण कथन के लिए विशेष रूप से महत्वपूर्ण नहीं है, लेकिन फिलहाल मैं फ़ाइल स्वरूपों के बीच इस रूबा गोल्डबर्ग के लिए जिम्मेदार लोगों के लिए दिलचस्प नियति प्रस्तुत करने में बहुत समय बिताता हूं।

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

PSD मेरा पसंदीदा प्रारूप नहीं है।

मैं घृणा के ऐसे स्तर तक नहीं पहुंचा था, लेकिन मुझे याद आया कि कैसे कुछ घरेलू डेवलपर्स के एपीआई के लिए कुछ दस्तावेज पढ़ते समय मेरी आंखों से खून बह रहा था।

अपना मनोरंजन करने का तरीका

हम जानते हैं कि प्रोग्रामर का काम कितना उबाऊ और एकाकी है। क्योंकि हम सभी कभी-कभी केवीएन में एक ही व्यक्ति की भूमिका निभाते हैं। ऐसा करने का सबसे सुरक्षित तरीका टिप्पणियों में है, लेकिन विकल्प हैं।

  # क्रिसमसम ट्री इनिशियलाइज़र  
     काट देना = []  
     पलटना = []  
     [=]   
     primes = []  
     प्रतिक्रियाएँ = {}  
     शेष = {} 

क्रिसमस ट्री इनिशियलाइज़र

  /////////////////////////////////////// यह एक अच्छी टिप्पणी वाली पंक्ति है 

खैर बाहर लाइन टिप्पणी की

  दोहराना
     ...
 तक (JesusChristsReturn) 'निश्चित नहीं है 

संदेह में धार्मिक हठधर्मिता ...

  // अगर मैं इसे फिर से देखता हूं तो मैं काम करने के लिए बंदूकें लाने जा रहा हूं 

एक बार फिर मुझे यह दिखाई देगा - मैं काम करने के लिए हथियार रखना शुरू करूँगा

  // इस बिंदु से परे प्रवेश करने वाले सभी आशाओं का त्याग करें 

यहां आने वाले सभी को उम्मीद छोड़ दें

  // नशे में, बाद में ठीक करें 

नशे को बाद में ठीक करें

एक मजाक के रूप में, और एक बार मैंने खुद को मॉनिटर पर स्टिकर पर एक समान नोट छोड़ दिया: "सोबर अप - चेक एक्सएक्सएक्स, वाईवाईवाई क्लासेस" ...

  पकड़ना (अपवाद ई) {
  // कौन परवाह करता है?
 } 

कौन परवाह करता है?

  // मुझे समझ नहीं आ रहा है कि निम्न बिट कैसे काम करता है, लेकिन यह उस कार्यक्रम में काम करता है जिसे मैंने इसे चुरा लिया है 

मुझे नहीं पता कि यह टुकड़ा कैसे काम करता है, लेकिन इसने कार्यक्रम में काम किया, जहां से मैंने इसे चुरा लिया।

  // यह कोड एक जीनियस द्वारा लिखा गया था इसलिए इसे समझने की कोशिश न करें
 // आपका छोटा सा दिमाग। 

यह कोड एक जीनियस द्वारा लिखा गया है। इसे अपने लघु मस्तिष्क के साथ समझने की कोशिश न करें।

  दोहरी पैठ;  // ouch 

और वास्तव में, ओह ...

  // जोड़ा गया क्योंकि बॉस ने अपना मन बदल लिया: 20020111,20020501,20020820, ...
 // टिप्पणी की क्योंकि बॉस ने अपना मन बदल लिया: 20020201,20020614,20020908, ... 

के बाद से जोड़ा गया बॉस ने अपना विचार बदल दिया ... टिप्पणी की, क्योंकि बॉस ने करवट बदली ...

  // हलेलुआ मैं घर जा सकता हूँ! 

अलेउलिया, मैं घर जा सकता हूं

मैं घर चला गया। और आप हमें बताएं कि आपकी सबसे यादगार या मजेदार टिप्पणी क्या थी।

हमारे साथ बने रहने के लिए धन्यवाद। क्या आप हमारे लेख पसंद करते हैं? अधिक दिलचस्प सामग्री देखना चाहते हैं? एक आदेश देकर या अपने मित्रों को इसकी अनुशंसा करके हमें समर्थन दें, एंट्री-लेवल सर्वरों के अनूठे एनालॉग पर हैबर उपयोगकर्ताओं के लिए 30% छूट जो हमने आपके लिए ईजाद की है: VPS (KVM) E5-2650 v4 (6 करोड़) 10GB DDR4 240GB SSD 1Gbps से पूरा सच $ 20 या सर्वर को कैसे विभाजित करें? (विकल्प RAID1 और RAID10 के साथ उपलब्ध हैं, 24 कोर तक और 40GB DDR4 तक)।

डेल R730xd 2 बार सस्ता? केवल हमारे पास 2 x Intel Dodeca-Core Xeon E5-2650v4 128GB DDR4 6x480GB SSD 1Gbps नीदरलैंड और यूएसए में $ 249 से 100 टीवी है ! इन्फ्रास्ट्रक्चर Bldg का निर्माण कैसे करें के बारे में पढ़ें । एक पैसा के लिए 9,000 यूरो की लागत डेल R730xd E5-2650 v4 सर्वर का उपयोग कर वर्ग?