comments पर टैग किए गए जवाब

कोड में टिप्पणी लिखने के बारे में प्रश्न।

16
जटिल कोड की व्याख्या करने वाली टिप्पणियों में क्या गलत है?
बहुत सारे लोग दावा करते हैं कि "टिप्पणियों में 'क्यों' की व्याख्या होनी चाहिए, लेकिन 'कैसे' नहीं।" दूसरों का कहना है कि "कोड को स्व-दस्तावेजीकरण होना चाहिए" और टिप्पणियों को दुर्लभ होना चाहिए। रॉबर्ट सी। मार्टिन का दावा है कि (मेरे अपने शब्दों में कहा गया है) अक्सर "टिप्पणियां बुरी …

23
मैं एक टीम के सदस्य के साथ कैसे व्यवहार कर सकता हूं जो कोड में टिप्पणी करना पसंद नहीं करता है?
मेरी टीम का एक सदस्य लगातार उसके कोड में टिप्पणी करने से बचता है। उनका कोड स्व-दस्तावेजीकरण नहीं है, और अन्य प्रोग्रामर को उनके कोड को समझने में मुश्किल समय लगता है। मैंने उनसे कई बार अपने कोड पर टिप्पणी करने के लिए कहा है, हालांकि वह सिर्फ बहाने देता …
182 teamwork  team  comments 

17
स्पष्टता के लिए कोडिंग मानक: कोड की प्रत्येक पंक्ति पर टिप्पणी करें?
मैंने उन दुकानों में काम किया है जो जीवन के लिए महत्वपूर्ण सॉफ़्टवेयर का उत्पादन करते हैं और मैंने उन नियमों को टिप्पणी करते हुए निपटाया है जो कोड पठनीय रखने और संभावित रूप से जीवन बचाने के लिए थे। मेरे अनुभव में हालांकि आवश्यकता एक ब्रेन डेड कोर की …

30
"टिप्पणियाँ एक कोड गंध हैं" [बंद]
मेरा एक सहकर्मी का मानना है कि किसी भी इन-कोड टिप्पणियों के उपयोग (यानी, नहीं जावाडोक शैली विधि या कक्षा टिप्पणियां) एक है कोड गंध । तुम क्या सोचते हो?

12
मेरा ग्राहक मेरे वर्तमान प्रोजेक्ट में 25% टिप्पणियां चाहता है, कैसे प्रतिक्रिया दें? [बन्द है]
जूनियर डेवलपर यहाँ। मैं वर्तमान में अपनी कंपनी के एक बड़े ग्राहक के लिए वेब एप्लिकेशन पर अकेले काम कर रहा हूं। मैंने पिछले महीने शुरू किया था। ग्राहक अपने प्रत्येक सॉफ्टवेयर प्रोजेक्ट में कम से कम 25% टिप्पणियां चाहता है। मैंने पिछले अनुप्रयोगों के कोड की जाँच की और …

17
क्या TODO टिप्पणियों से समझ में आता है? [बन्द है]
मैं काफी बड़े प्रोजेक्ट पर काम कर रहा हूं और मुझे इसके लिए कुछ अनुवाद करने का काम मिला है। कई टन लेबल थे जिनका अनुवाद नहीं किया गया था और जब मैं कोड के माध्यम से खुदाई कर रहा था तो मुझे कोड का यह छोटा सा टुकड़ा मिला …

9
स्वच्छ कोड टिप्पणियाँ बनाम वर्ग प्रलेखन
मैं टिप्पणी करने के संबंध में अपने नए सहयोगियों के साथ कुछ चर्चा कर रहा हूं। हम दोनों को क्लीन कोड पसंद है , और मैं इस तथ्य से पूरी तरह से ठीक हूं कि इनलाइन कोड टिप्पणियों से बचा जाना चाहिए और जो वे करते हैं उसे व्यक्त करने …

13
टिप्पणी-आउट कोड मूल्यवान प्रलेखन हो सकता है?
मैंने निम्नलिखित कोड लिखा है: if (boutique == null) { boutique = new Boutique(); boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); boutique.setUrlBoutique(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getUrl()); boutique.setNom(fluxBoutique.getNom()); boutique.setSelected(false); boutique.setIdWebSC(fluxBoutique.getId()); boutique.setDateModification(new Date()); boutiqueDao.persist(boutique); } else { boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); boutique.setUrlBoutique(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getUrl()); boutique.setNom(fluxBoutique.getNom()); //boutique.setSelected(false); boutique.setIdWebSC(fluxBoutique.getId()); boutique.setDateModification(new Date()); boutiqueDao.merge(boutique); } यहाँ एक टिप्पणी-बाहर लाइन है। लेकिन मैं इसे कोड साफ बनाता है, स्पष्ट कर …

13
टिप्पणियों के उदाहरण क्या हैं जो आपको बताते हैं कि इसके बजाय कैसे या क्या? [बन्द है]
सबसे पहले, इस प्रश्न में मैं पोलिमिक से दूर रहना चाहूंगा कि क्या स्रोत कोड टिप्पणी करना अच्छा है या बुरा। मैं सिर्फ और अधिक स्पष्ट रूप से समझने की कोशिश कर रहा हूं कि लोग क्या मतलब रखते हैं जब वे टिप्पणियों के बारे में बात करते हैं जो …

22
स्रोत कोड के कमेंट में टिप्पणी जोड़ने के लिए मैं अपने साथी देवों को कैसे मनाऊं?
मुझे पता है कि तोड़फोड़ (जो हम काम में उपयोग कर रहे हैं) को कमिट पर टिप्पणियों की आवश्यकता के लिए कॉन्फ़िगर किया जा सकता है, हालांकि मैं इसे चालू करने के लिए शक्ति की स्थिति में नहीं हूं। मुझे पता है कि मेरे कमेंट्स को कमेंट करने का मेरा …

17
मैं अपने बॉस (विनम्र तरीके से) से उसका कोड कैसे पूछ सकता हूं?
मुझे मेरे बॉस द्वारा पढ़ाया जा रहा है (मैंने अभी स्कूल समाप्त किया है और वह किसी को थोड़ा प्रोग्रामिंग अनुभव के साथ चाहता है, इसलिए उसने मुझे चुना कि मुझे उस कंपनी को प्रशिक्षित करने के लिए क्या करना है) और ASP.NET MVC अनुप्रयोगों, कुछ HTML और CSS के …
72 comments 

9
एक टिप्पणी में XXX का क्या अर्थ है? [बन्द है]
जब भी आप XXXकिसी टिप्पणी में देखते हैं तो लोग आम तौर पर क्या करते हैं । कभी-कभी, मैं इस तरह की टिप्पणी देखूंगा: # XXX - This widget really should frobulate the whatsit बेशक, मैं बता सकता हूं कि टिप्पणी का क्या मतलब है, लेकिन XXX का आम तौर …

16
क्या पहले व्यक्ति टिप्पणी विचलित और अव्यवसायिक हैं?
मैंने अपने आप को कुछ (पुरातन विज़ुअल बेसिक 6.0) कोड में निम्नलिखित टिप्पणी लिखते हुए पाया: मैं लिख रहा था: If WindowState <> 1 Then 'The form's not minimized, so we can resize it safely '... End if मुझे यकीन नहीं है कि मैं अपनी टिप्पणियों में "हम" का उपयोग …

7
TODO की समय सीमा के साथ टिप्पणी?
पृष्ठभूमि मैं एक टीम में काम कर रहा हूँ जो शून्य-डाउनटाइम परिनियोजन लागू करना चाहती है। हम इसे प्राप्त करने के लिए एक नीली / हरी परिनियोजन रणनीति का उपयोग करने की योजना बना रहे हैं। अनुसंधान करने में मुझे जो चीजें महसूस हो रही हैं, उनमें से एक यह …

11
/// टिप्पणी ब्लॉक महत्वपूर्ण क्यों हैं?
किसी ने एक बार कहा था कि हमें अपने सभी तरीकों को /// <summary>टिप्पणी ब्लॉक (C #) के साथ उपसर्ग करना चाहिए लेकिन यह नहीं बताया कि क्यों। मैंने उनका उपयोग करना शुरू कर दिया और पाया कि उन्होंने मुझे बहुत परेशान किया, इसलिए पुस्तकालयों और स्थिर तरीकों को छोड़कर …
49 c#  comments 

हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.