स्रोत कोड के कमेंट में टिप्पणी जोड़ने के लिए मैं अपने साथी देवों को कैसे मनाऊं?


78

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

  1. इसमें बहुत लंबा समय लगता है और मैं सिर्फ रेपो में अपने बदलाव लाना चाहता हूं।
  2. यह काफी आसान है बस डिफरेंसेस को देखें।

मैं उन्हें केवल JIRA इश्यू आईडी में डालने का मूल्य दिखाता हूं और यह कैसे स्वचालित रूप से मुद्दे से जुड़ जाता है, लेकिन फिर भी उनके पास कोई पासा नहीं है।

सबसे बुरा यह है कि जो व्यक्ति कॉल कर सकता है, वह एक ही शिविर में है: परेशान नहीं होना चाहता है और अलग-अलग चीजों को देखकर ठीक है।

मुझे पता है कि यह करना सही है, लेकिन मैं उन्हें प्रकाश कैसे देख सकता हूं? यहां तक ​​कि अगर मैं अपने साथी देवों को मना नहीं सकता, तो मैं प्रबंधन को कैसे मना सकता हूं कि यह व्यवसाय के लिए सही काम है?


4
क्या आपको किसी विशेष मानकों को पूरा करने की आवश्यकता है, उदाहरण के लिए आईएसओ या सीएमएमआई प्रमाणीकरण? यदि आप करते हैं, तो प्रबंधन को समझाना काफी आसान हो जाता है। इसके अलावा ... शुभकामनाएँ। यदि आप अन्य डेवलपर्स को उन्हें लाभ दिखाने के बाद भी मना नहीं सकते हैं, तो मुझे यकीन नहीं है कि आप प्रबंधन को कैसे मना सकते हैं।
थॉमस ओवेन्स

11
@ChrisSimmons: उन्हें टिप्पणी करना चाहते हैं बनाने के लिए ... क्या आपने सम्मोहन की कोशिश की है? गंभीरता से, मुझे नहीं लगता कि वे इसे तब तक करना चाहते हैं जब तक कि वे या तो: 1) किसी तरह की समस्या का अनुभव न करें टिप्पणी की कमी से उपजी 2) कुछ तत्काल लाभ प्राप्त करने में सक्षम हैं।
FrustratedWithFormsDesigner

4
"बहुत लंबा समय लेता है"? मुझे कभी भी स्रोत नियंत्रण पर किसी भी टिप्पणी पर एक मिनट से अधिक खर्च करने की याद नहीं है। अधिक 10 सेकंड की तरह।
jsternberg

4
"उन्हें दर्द का कारण" कोण पर, ऐसा करने का सबसे अच्छा तरीका है कि मैं उन्हें "मैं अपना प्रतिबद्ध मुद्दा एक्स निर्धारित नहीं कर पाऊं" कुछ समय के लिए। (हालांकि दर्द पैदा करने का सबसे अच्छा तरीका एक सकारात्मक प्रोत्साहन के रूप में भी काम नहीं करेगा।)
डेविड श्वार्ट्ज

4
यदि आप समस्याओं के लिए बग ट्रैकिंग सॉफ़्टवेयर का उपयोग करते हैं, तो कमेंट में टिप्पणी जोड़ना उतना ही सरल हो सकता है #10291। संदर्भ तुरंत स्पष्ट हो जाएगा, और सभी प्रासंगिक विवरण पहले से ही बग ट्रैकिंग सिस्टम में होना चाहिए।
zzzzBov

जवाबों:


78

"क्यों" पर ध्यान दें। इसकी सभी बहुत अच्छी तरह से अंतर को देखते हैं और देखते हैं कि किसी ने कोड के एक खंड या इस तरह के कुछ के तार्किक प्रवाह को बदल दिया, लेकिन इसे क्यों बदला? क्यों संबंधित टिकट (आमतौर पर आपके लिए JIRA) में है।

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

ऑडिटिंग कारण भी है। बाइंडिंग कमिट और टिकट आईडी से ओके कहना वास्तव में आसान हो जाता है, हम संस्करण 2 को धकेल रहे हैं, यह सुधार 23, 25, 26 और 27 को ठीक करता है, लेकिन दोष 24 के खिलाफ कोई कमिट नहीं है, इसलिए यह अभी भी बकाया है।


यह संभवतः "क्यों" के बारे में नहीं है। ऐसे लोग हैं जो सीखने में मना कर देते हैं। उन्हें प्रेरणा की जरूरत है, न कि स्पष्टीकरण के बढ़ते बैराज की।
rivalk

1
इस मामले में, मुझे लगता है कि whyचेक-इन का उत्तर देना ठीक है कि आप क्या कर रहे हैं: डेवलपर्स को एक अच्छा कारण (AKA प्रेरणा) दे रहे हैं कि उन्हें क्यों (सार्थक) चेक-इन टिप्पणियों का उपयोग करना चाहिए।
बजे एक CVn

5
यह उस व्यक्ति को समझाने की बात है जो कॉल कर सकता है। उपयुक्त प्रतिक्रिया है: "बिना किसी स्पष्ट कारण के कल सत्रह आने थे। यह देखते हुए कि वे किसी भी उत्कृष्ट बग या मुद्दों में योगदान नहीं करते हैं, उन्हें वापस ले लिया गया है।"
क्रिस कूडमोर

2
आपको एक अनुकूल प्रेरक का उपयोग करने की आवश्यकता है ।
सोयलेंटग्रे

1
पुराना करीबी कोड "WAD" है - वर्किंग अस डिज़ाइन। वहाँ भी मजाक कोड "WAC" कोड - कोडित के रूप में काम कर रहा है। अंतर बताने में सक्षम होना अच्छा है।
वुडांग

33

उन्हें मर्ज करें और समर्थन से निपटें। फिर शायद आप ऐसा करने की स्थिति में नहीं हैं, लेकिन यदि आप पाते हैं कि कोई व्यक्ति पिछली प्रतिबद्धताओं से किसी समस्या का निवारण करने के लिए विनम्रता से इसे बाड़ पर भेजता है और कहता है। मैं नहीं बता सकता कि आपने क्या किया क्योंकि कोई टिप्पणी नहीं है, आपने ये बदलाव किए हैं जिन्हें आपको यह पता लगाने की आवश्यकता है।

शाखाओं के विलय के लिए भी। यकीन नहीं होता है कि आप पर पड़ता है या नहीं, लेकिन यह एक ऐसा क्षेत्र है जो मुझे टिप्पणियों के लिए उपयोगी लगा।

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


4
मुझे स्टेटस रिपोर्ट एंगल का आइडिया पसंद आया। "जो व्यक्ति कॉल कर सकता है" मैंने उल्लेख किया है कि अपनी स्थिति रिपोर्ट के लिए वह उस स्तर पर विक्रय बिंदु हो सकता है।
क्रिस सीमन्स

14
+392,481 के लिए "अच्छी स्थिति साप्ताहिक स्थिति रिपोर्ट के बदले में काम करेगी।" यह स्पष्ट है कि उन्हें "क्यों" मदद नहीं दिखा रहा है और मदद नहीं करेगा। इस तरह के रचनात्मक समाधान उन्हें अच्छे प्रतिबद्ध संदेश विकसित करने में मदद करेंगे।
rivalk

मैं भी। वापस जब मुझे बहुत सारे ठीक-ठाक समय-पत्रक पूरे करने थे, तो मैं यह अनुमान लगाने के लिए प्रतिबद्ध समय टिकटों का उपयोग करूँगा कि मैंने प्रत्येक कार्य पर कितना समय बिताया है।
mikerobi

1
"उन्हें बनाओ ... समर्थन से निपटो।" मेरे लिए विजेता है। कुछ वर्षों के लिए एक विरासत उत्पाद का समर्थन करने के बाद, मैं किसी प्रकार की टिप्पणी के बिना खुद को प्रतिबद्ध करने के लिए नहीं ला सकता।
मलाची

मुझे आश्चर्य है कि अगर मैं इस एंगल का इस्तेमाल अपने मैनेजर को स्टेटस मीटिंग्स (वर्तमान में ५-मैन डेविल्स के लिए प्रति सप्ताह ३ पर) में कटौती करने के लिए मना सकता हूं।
ग्रेफेड

26

हमें अपने कोड में लाइन ब्रेक और स्पेसिंग की आवश्यकता होती है उसी कारण से हमें चेक-इन टिप्पणियों की आवश्यकता है। चीजों को ट्रैक करना आसान बनाने के लिए, पढ़ने और समझने को समझें।

कभी-कभी आपको तुलना करने की आवश्यकता होती है, लेकिन अक्सर आप नहीं करते हैं। मजबूरन देवों की तुलना करने के लिए जब उन्हें जरूरत थी 2-3 वाक्य पढ़ने के लिए समय की कुल बर्बादी है। मुझे आश्चर्य है कि वे डेवलपर समय का मूल्य क्यों नहीं देखते हैं।


4
+ इसके लिए 365,000 रु। मुझे समझ में नहीं आता है कि एक वाक्य लिखना इतना "कठिन और समय लेने वाला" क्यों होता है जब कोई भिन्न होता है।
जेनिफर एस

2
मैं इसे "अपने साथियों के बारे में एक cr * p देता हूं।" आपको लगभग कभी भी अंतर को नहीं देखना चाहिए, बहुत कम (बेशक और वर्तमान नीति)।
एरिक

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

डरपोक पहिया होने से डरो मत। अन्य लोगों की बुरी आदतों से लड़ना अक्सर एक युद्ध की स्थिति होती है।


12

यह मैंने सुना है सबसे विचित्र प्रश्नों में से एक है। लोग घंटों या कुछ दिन बिताते हैं और एक अतिरिक्त संदेश में टाइप करने के लिए एक अतिरिक्त 2 सेकंड बहुत लंबा है ?! मेरा कहना है कि मैं ऐसे कम दृष्टि वाले लोगों के साथ काम करने के बारे में चिंता करूंगा। वे स्पष्ट रूप से अपनी पूरी क्षमता के करीब भी अपने उपकरणों का उपयोग नहीं कर रहे हैं।

पिछले सप्ताह एक कोड समीक्षा से मैं एक उदाहरण में शामिल था। हमारे संस्करण नियंत्रण सॉफ्टवेयर मर्ज में इतिहास को संरक्षित नहीं करता है, इसलिए पुराने परिवर्तनों के लिए आपको सटीक शाखा ढूंढनी होगी जो इसे बनाया गया था, अन्यथा प्रतिबद्ध संदेश बस "शाखा वाई से विलय" जैसा कुछ दिखाता है। शाखा Y "शाखा Z से विलीन" दिखा सकती है और वास्तव में वास्तविक प्रतिबद्ध संदेश में एक शाखा गहरे स्तर के घोंसले का शिकार है।

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

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

पूरी तरह से यूनिट परीक्षणों की तरह, उन प्रकार के रजिस्टरों को पेश करने से बचने के लिए बेहतर तरीके हैं, लेकिन किसी तरह मैं ऐसे लोगों को नहीं देखता जो यूनिट परीक्षण पर 2-सेकंड के कमिटमेंट मैसेज "बर्बाद" के साथ परेशान नहीं कर सकते।


1
"लोग घंटे या दिन भी बिताते हैं और कुछ और एक अतिरिक्त 2 सेकंड फिक्स करने के लिए एक प्रतिबद्ध संदेश में टाइप करना बहुत लंबा है ?!" अरे, मैं देख रहा हूं कि लोग एक दुकान के अंदर मीलों पैदल चल रहे हैं, लेकिन जब वे अपनी कार में वापस आते हैं, तो किसी तरह अपनी खरीदारी की गाड़ी को पचास फीट की दूरी पर कार्ट कोरल पर धकेलना पड़ता है। आलसी लोग इस बात पर विचार करने के लिए बहुत आलसी होते हैं कि वे कितने आलसी हैं।
Kyralessa

इसीलिए डेड कोड (यानी कमेंट-आउट कोड) को हटा दिया जाना चाहिए, न कि एक साल के लिए टिप्पणी छोड़ दी गई।
Cthulhu

10

मुझे यहाँ बिल्कुल वही समस्या थी, इसलिए मैंने तोड़फोड़ के लिए एक प्री-कमिट हुक जोड़ा ताकि यह किसी भी तरह के कमिट को स्वीकार न करे जो कि यूजर स्टोरी नंबर (कुछ बेसिक पैटर्न से अपेक्षित फॉर्मेट के लिए मेल खाते) से शुरू नहीं हुआ था।

वहाँ उन्हें 000-0000 में प्रवेश करने से कुछ भी नहीं रोक रहा है, लेकिन एक बार केवल एक विघटनकारी बेवकूफ एक संख्या बनाने जा रहा है जब उनके पास वहां पूरी तरह से स्वीकार्य है।

मैंने ऐसा दिन बिताने के बाद किया, जिसमें यह पाया गया कि उपयोगकर्ता कहानियों का एक सेट बनाता है। हाँ, यह एक प्रक्रिया विफलता से निपटने के लिए और कहाँ था, लेकिन यह अभी भी अविश्वसनीय रूप से मूल्यवान जानकारी है।


1
-1 उन्होंने कहा कि वह इसे चालू नहीं कर सकते।
आहारबुद्ध

@ दिदिबुद्ध: लेकिन उसके पास इसे चालू करने के लिए एक और तर्क है, और इससे पहले किसी ने भी पूर्व-प्रतिबद्ध हुक का उल्लेख नहीं किया था।
बाइनरी वॉरियर

7

अच्छी प्रतिबद्ध टिप्पणियाँ किसी भी अच्छे दस्तावेज की तरह होती हैं, आपके धीमे और विचलित मस्तिष्क के लिए कैश या किसी लंबी डिबगिंग / समस्या विश्लेषण / जांच के परिणाम का एक कैश।

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

फिर भी, दस्तावेज़ीकरण में समय लगता है और कभी-कभी ऐसा लगता है कि यह आवश्यक नहीं है, जैसे "हमें केवल एक बार ऐसा करना था, इसलिए इसे नीचे लिखें"। यह ठीक है, लेकिन जैसे ही आप दूसरी बार एक ही काम करते हैं क्योंकि आपने पहली बार परिणामों का दस्तावेज नहीं बनाया है, तो यह निश्चित रूप से परिणामों को दस्तावेज करने के लिए चतुर है।

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

मेरी राय में, दस्तावेज़ीकरण का अनुरोध सूचना के एक समारोह के रूप में किया जाना चाहिए। उदाहरण के लिए, मेल पत्राचार एक बहुत अच्छा प्रलेखन प्रणाली है। प्रश्नों के उत्तर प्राप्त होते हैं जिन्हें बाद में पुनर्प्राप्त किया जा सकता है, यह है कि मेलिंग सूची और फ़ोरम ज्ञान के आधार के रूप में व्यवहार में कैसे काम करते हैं।

दुर्भाग्य से, जहां मैं काम करता हूं, 3 महीने बाद मेल स्वचालित रूप से हटा दिया जाता है, इसलिए यह हमेशा अभ्यास में काम नहीं करता है।


6

क्षमा मांगो, अनुमति नहीं।

कठोर होते हुए भी मैंने बस यही किया। मैंने समर्थन करने वाले लोगों और विरोध करने वाले लोगों के बीच 50/50 का विभाजन किया, जिनमें से अधिकांश समूह में मेरे समान ही थे। तर्क थे "मुझे परेशान नहीं किया जा सकता" और "क्या बात है?"। (दोनों उदासीनता और आलस्य का संकेत देते हैं, वास्तविक चिंताओं का नहीं)।

मैंने प्री-कमिट हुक जोड़ा जो कि स्ट्रिंग की लंबाई को मापता था और इसे अस्वीकार करने से पहले थोड़ा हास्य संदेश देता था। मैंने अपना नाम संदेश में रखा, इसलिए "इस आक्रोश" के लिए ज़िम्मेदारी स्पष्ट थी। बेशक, "विपक्ष" इसे आसानी से हटा सकता है, लेकिन स्क्रिप्ट में खुदाई एक और टिप्पणी जोड़ने से अधिक प्रयास करेगी!

एक हफ्ते के लिए मुझे * * (एक्सक्लूसिव डिलीट) या kjhfkwhkfjhw जैसे मैसेज मिले। उसके बाद, मूल संदेश दिखाई देने लगे।

एक वर्ष पर और संशयवादी टिप्पणी का उपयोग करते हैं और वास्तव में स्वीकार करते हैं कि वे कितने अदूरदर्शी थे। मुझे कभी भी सहमति नहीं मिल सकती थी, लेकिन मुझे निश्चित रूप से माफी मिली और शायद विश्वसनीयता। यह काम करता है, लोग इसका उपयोग करते हैं।

यदि आप अधिक जन्मजात होना चाहते थे (या महसूस करते हैं कि आप मुसीबत में पड़ेंगे), तो परीक्षण अवधि के लिए एक प्रतिबद्ध हुक जोड़ने की अनुमति मांगें। यह कहें कि यदि 2 सप्ताह या 4 सप्ताह में लोग इसे पसंद नहीं करते हैं, तो आप इसे निकाल लेंगे। संभावना है, वे रुचि खो देंगे ... या इसे पसंद करने के लिए बढ़ेंगे।


5

मैं आमतौर पर लोगों को समझाता हूं:

  • अच्छे सहायक कारणों के साथ द्वंद्वात्मक
  • मिसाल के हिसाब से आगे बढ़ना
  • संघर्षण

अगर मैं चाहता कि हमारी टीम कुछ बुरा कर सके तो मैं तब तक मूसल थामे रहूंगा, जब तक कि मुझे अपना रास्ता नहीं मिल जाता। मैं उन समय के दौरान पेस्टर करने की कोशिश करता हूं जहां मैं इंगित कर सकता हूं कि हम समय बचा सकते थे / पैसा हम पहले से ही एक्स कर रहे थे।

टिप्पणी करने के लिए अतिरिक्त अच्छे कारण:

  • ChangeLog को टिप्पणियों से स्वचालित रूप से उत्पन्न करना।
  • बग फिक्स, सुविधा परिवर्धन के लिए ऑडिट ट्रेल। यह टीम के अंदर और बाहर दोनों जगह उपयोगी है।
  • मेल को अधिक उपयोगी बनाएं।
  • मुझे डेवलपर से पूछने से रोकें कि एक्स क्या करता है (लगभग हर कमिट के बाद)।

3
  • 6 महीने पहले किए गए कुछ अस्पष्ट के लिए आपको एसवीएन लॉग की जाँच करें।
  • इस बात के बारे में कुछ प्रश्न पूछें कि यह कब किया गया है
  • ???
  • फायदा

2

आप उन्हें कैसे अच्छी टिप्पणियाँ जोड़ना चाहते हैं?

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

इसलिए - टेकअवे - एक समाधान यह हो सकता है कि डेवलपर्स परियोजना के अंत में सारांश दस्तावेज लिख सकते हैं कि क्या फाइलें, क्या फाइलें जोड़ी गईं / हटा दी गईं और क्यों क्या बदलाव किए गए।


2

बंद दरवाजों के पीछे प्रबंधन को इसका प्रस्ताव दें:

सबसे खराब स्थिति यह होती है: सभी वरिष्ठ स्तर के डेवलपर्स दरवाजे से बाहर निकलते हैं।

चूंकि कंपनी खाली डेवलपर सीटों को भरने के लिए हाथापाई करती है, प्रबंधन टीम को क्लाइंट के लिए सिस्टम की स्थिति को सूचित करने का काम सौंपा जाता है।

उनसे पूछें कि उन्हें क्या लगता है कि ऐप के इतिहास को फिर से बनाने में उनका काम आसान हो जाएगा:

सादे अंग्रेजी पढ़ना यह स्पष्ट करता है कि सिस्टम की बदलती स्थिति का स्पष्ट रूप से वर्णन करें?

या वे कोड अंतर को देखना पसंद करेंगे और इसे स्वयं समझ लेंगे?


1

मुझे लगता है कि उन्हें समझाने का एक तरीका वास्तव में उस दर्द का अनुभव करना होगा जो आप महसूस कर रहे हैं।

उदाहरण के लिए, मान लें कि वे निम्नलिखित समस्या पर काम कर रहे हैं: उनके पास एक बग है, जो किसी तरह तब दिखाई देता है जब उसी कोड के लिए एक और बग फिक्स (ओह विडंबना) लागू किया गया था। इसे देखने के लिए केवल प्रतिबद्ध संदेशों के माध्यम से खोज करने में सक्षम होना महान होगा (और इस तरह पता करें कि इसे किसने लिखा है)।

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


1

हालाँकि, यह उन दो प्रतिक्रियाओं का मुकाबला करने के लिए पर्याप्त नहीं है जो मुझे हमेशा मिलती हैं:

  1. इसमें बहुत लंबा समय लगता है और मैं सिर्फ रेपो में अपने बदलाव लाना चाहता हूं।
  2. यह काफी आसान है बस डिफरेंसेस को देखें।

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

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

विचार करने के लिए कुछ और है कि आप कैसे अच्छी तरह से जानते हैं कि आपके साथी डेवलपर्स क्या काम कर रहे हैं? यदि वे कल 10 चीजें प्राप्त करने की कोशिश कर रहे हैं तो मैं समझ सकता हूं कि वे जो कुछ पहले से ही काम कर रहे हैं उसे वे नहीं बदलना चाहते। क्या आप उन्हें बताने की कोशिश कर रहे हैं, "नहीं, यह काम नहीं करता है?" यदि हां, तो मैं देख सकता हूं कि वे इस पर थोड़ा रक्षात्मक या जुझारू कैसे हो सकते हैं। यदि आप उन्हें बताने की कोशिश कर रहे हैं, "जबकि यह काम कर सकता है, एक विकल्प है जो बेहतर हो सकता है ..." तो आपके पास एक मौका हो सकता है। यहां "होली से बेहतर" रवैया रखने से आपको मदद नहीं मिलेगी।


1

इसे देखने का एक अन्य तरीका डेवलपर के लिए अपने करियर को विकसित करने के लिए एक तरीका है - उन्हें अपने काम के प्रलेखन का मालिक होना चाहिए ।

उपर्युक्त लेख में उठाए गए अन्य बिंदुओं के अलावा, कोड परिवर्तनों की समीक्षा करने में सक्षम होने की क्षमता है कि कहां / कब / क्यों एक बदलाव किया गया था। मायावी बग को ट्रैक करते समय यह महत्वपूर्ण हो सकता है।


0

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

हालांकि, यह महत्वपूर्ण है कि वे व्हेन को समझें क्योंकि @ केविन ने कहा, वरना वे अभी भी किसी भी यादृच्छिक टिप्पणी को जोड़ देंगे।


0

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

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

जब आप टिप्पणी नहीं लिखते हैं, तो आप मैला और अनुशासनहीन होते हैं। और यदि आप जोर देते हैं कि आपको टिप्पणियों को लिखने की आवश्यकता नहीं होनी चाहिए, तो आप जानबूझकर लापरवाही बरत रहे हैं।


0

उन्हें 50,000 रेखा विधियों की प्रक्रियात्मक गड़बड़ी को बनाए रखने का एक ही तरीका बताएं, फिर भविष्य में बेहतर, अधिक स्पष्ट कोड लिखने पर विचार करें ताकि आपको अपने कोड आधार को नष्ट करने वाले व्यर्थ टिप्पणियों के एक समूह से निपटना न पड़े।


0

यह एक प्रक्रिया परिवर्तन आइटम है: क्या एक प्रबंधक असाइन कोड "x" द्वारा "Y" के लिए गुणवत्ता आश्वासन जांच के लिए अकेले कोड पर विकसित किया गया है, जिसमें टिप्पणियों का क्यूए भी शामिल है।

मेरे अपने संगठन में डेवलपर्स को अपने स्वयं के कोड के अंतिम क्यूए को निष्पादित करने और इसे जांचने की अनुमति नहीं है, यह किसी अन्य डेवलपर द्वारा किया जाना है। क्यूए चेक का हिस्सा टिप्पणियां हैं, इसलिए कोई टिप्पणी नहीं, कोई चेक इन नहीं। हम बहुत सारे अनुबंध कार्य करते हैं जहां हमारी "कला" वास्तव में किसी और की संविदात्मक बौद्धिक संपदा है, इसलिए दूसरों को हमारे कोड को समझने और इसका लाभ उठाने में सक्षम होने की आवश्यकता है। इसके अलावा, ऐसे समय होते हैं जब परियोजनाएं लंबे अंतराल के बाद हमारे पास वापस आती हैं और हमें 18-24 महीने बाद कोड लेने में सक्षम होना चाहिए और यह समझना चाहिए कि क्यों, कहां और कैसे हमारे सामने कोड विरूपण साक्ष्य पहुंचे। यह प्रतिबद्ध टिप्पणियाँ लिखने के लिए एक स्व-सेवारत प्रेरणा प्रदान करता है।


0

पूछें और अपने साथी डेवलपर्स को कुछ मर्ज करने और इतिहास देखने और इतिहास की कुछ फाइलों की तुलना करने के लिए कहें।

संभावना है कि वे आपको अगले दिन टिप्पणी करने के लिए कहेंगे।


0

यहाँ कुछ सलाह है:

  1. दुनिया को बदलने की कोशिश मत करो। आप विफल होंगे।
  2. इसके बजाय आपको यह पहचानना चाहिए कि हर कोई थोड़ा अलग तरीके से काम करता है। कोई भी आकार हर किसी के लिए उपयुक्त नहीं है।
  3. लोगों की कार्य प्रक्रियाओं के लिए कुछ विशिष्ट चरणों की आवश्यकता बहुत बुरी है। इन प्रक्रियाओं को बदलने में 10 साल लगते हैं। आप उन्हें अगली समय सीमा से पहले ऐसा करने के लिए कह रहे हैं।
  4. यहां तक ​​कि सरल प्रक्रिया परिवर्तन में लंबा समय लग सकता है।
  5. कमिट्स पर कुछ छोटी टिप्पणी इन प्रक्रियाओं को बदलने के लिए बहुत महत्वहीन है।
  6. आप मान सकते हैं कि वे गुणवत्ता वाले काम करते हैं, लेकिन खुद को चुनने के लिए पर्याप्त स्वतंत्रता देनी चाहिए। अनुभवी डेवलपर्स के लिए कुछ बोझिल कदमों की आवश्यकता नहीं हो सकती है।
  7. यदि आप नए-नए बच्चों की देखभाल कर रहे हैं, तो मजबूत प्रक्रियाएं आवश्यक हो सकती हैं, लेकिन अनुभवी डेवलपर्स को बुलशिट से निपटना नहीं चाहिए।
  8. कैसे काम किया जाना चाहिए पर ड्रैकियन प्रतिबंधों को लागू करना कभी भी काम करने वाला नहीं है, यह केवल लोगों को धीमा कर सकता है (यदि वे बहुत तेज़ हैं तो अच्छा हो सकता है)
  9. बहुत सारे लोग हैं जो सोचते हैं कि उनका तरीका ही चीजों को करने का एकमात्र सही तरीका है। आशा है कि आप उनमें से नहीं हैं।

0

यदि आपका स्रोत नियंत्रण इसे साबित करता है, तो किसी भी गैर-टिप्पणी वाले कमिट को रोकने के लिए अनिवार्य टिप्पणियों को चालू करें। काफी सरल और सभी को जल्द ही पता चल जाएगा कि टिप्पणी लिखने के 5 सेकंड दर्द रहित हैं।

लेकिन संयुक्त राष्ट्र की टिप्पणी सबसे छोटी नकारात्मक है। मैं कई सफल परियोजनाओं का हिस्सा रहा हूँ जहाँ एक भी टिप्पणी नहीं की गई थी। उस पर एक गुच्छा में अपनी जाँघिया नहीं मिलता है।

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