रिकॉर्डिंग कीड़ों के बारे में, या एक बिल्ली का पता लगाएं

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

परिचय: एक बिल्ली का पता लगाएं

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

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

अक्सर एक वीडियो बग से जुड़ा होता है। सब के बाद, वीडियो सब कुछ दिखाता है!
वहां सब कुछ समान है, केवल घास अभी भी झूल रही है (माउस चालें) और द्वार खुले (अप्रासंगिक संवाद)।
इस बिंदु पर, मैं बग को रिकॉर्ड करने के नियमों के बारे में बात करता हूं, जिसे मैं अपने लिए पालन करने की कोशिश करता हूं, और जिसे मैं दूसरों को सलाह देता हूं।

रिकॉर्डिंग कीड़े के लिए मेरे व्यक्तिगत नियम

1) बग हेडर में कीवर्ड
ताकि आप जल्दी से समझ सकें कि किसकी क्षमता बग से संबंधित है।

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

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

4) स्क्रीनशॉट अच्छे हैं
चित्र एक दृश्य संदर्भ प्रदान करते हैं, उत्पाद के डेवलपर भागों को समस्याओं के साथ दिखाते हैं, और वह तुरंत ज्ञान के आवश्यक क्षेत्र को समझता है। इस संबंध में चित्र कीवर्ड के साथ मिलकर काम करता है (पैराग्राफ 1 देखें)

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

6) स्पष्ट निष्पादन के साथ ट्रेस ट्रेस / कंसोल त्रुटियों
खैर, लगभग हर कोई इसे समझता है और इसे लागू करता है, मैं केवल सूची की पूर्णता के लिए लिखता हूं।

7) प्लेबैक के लिए एक उदाहरण ।
यदि हम किसी प्रकार के डेस्कटॉप सिस्टम के बारे में बात कर रहे हैं, तो हमें एक संग्रह की आवश्यकता है, जिस पर समस्या का पुनरुत्पादन किया जाता है।
वेब पर यह आसान है - आप अक्सर एक ऑनलाइन डेमो (या एक विस्तारित मंचन पर्यावरण) के लिए एक लिंक दे सकते हैं।

यह सब एक पहले सन्निकटन में है।

मैं इसे अन्य लोगों के साथ साझा करता हूं - और अक्सर वे मुझ पर विश्वास करते हैं और वही करने लगते हैं।
आगे के उदाहरण और 20% विवरण, जो लेख के 80% पर कब्जा कर लेते हैं :)

उदाहरण

बग का एक उदाहरण है कि मैं उन्हें कैसे लिखता हूं, और जो कम या ज्यादा होता है :)

dxTreeView वर्चुअल मोड में अनावश्यक लोडिंग संकेतक बनाता है

• Http://js.devexpress.com/Demos/WidgetsGallery/#demo/navigation-tree_view-virtual_mode खोलें
• डबल क्लिक का उपयोग करके पत्ती नोड्स पर नेविगेट करें
• कई बार लीफ नोड्स पर डबल-क्लिक करें
  
  • अपेक्षित परिणाम: कुछ नहीं होता है
  • वास्तविक परिणाम: प्रत्येक डबल क्लिक पर एक लोडिंग इंडिकेटर बनाया जाता है और इसे कभी नहीं हटाया जाता है

दर्शन और मामूली परिभाषित विवरण

स्क्रीनशॉट तैयारी

चित्र बड़े लाल तीर या कैप्शन के साथ होने चाहिए।
स्क्रीनशॉट को बग के शरीर का हिस्सा होना चाहिए, पाठ में सही।
यदि अधिकांश आधुनिक प्रणालियों में बग की सूचना दी जाती है, तो यह बस Ctrl + V द्वारा क्लिपबोर्ड से चित्र को चिपकाकर किया जाता है

आप केवल चित्र का लिंक क्यों नहीं दे सकते? क्योंकि संदर्भ की हानि है। यदि आप चित्र देखते हैं, तो आप पाठ नहीं देखते हैं। यदि आप पाठ देखते हैं, तो आप चित्र नहीं देखते हैं। यदि आप यह और वह दोनों देखते हैं - इस बात की संभावना कि मस्तिष्क में कुछ क्लिक अधिक है।

पेशेवर विकृति का एक मिनट
यही कारण है कि डेटा विश्लेषण घटना के रूप में डैशबोर्ड लोकप्रिय हो रहे हैं :)
जब कोई व्यक्ति एक ही डेटा को विभिन्न स्वरूपों में और विभिन्न कोणों से देखता है, तो अंतर्दृष्टि उसके पास आ सकती है।
विवरण के लिए स्टीवन फ्यू और अन्य लेखकों को देखें।

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

स्क्रीनशॉट के उदाहरण, छोटे से बड़े तक:

• क्रिमिनल कोड में बग रिपोर्ट, रेलिंग टूट गई है
  
  समस्या स्पष्ट रूप से दिखाई देती है, लेकिन संदर्भ खो जाता है। यदि शब्दों में कोई शिलालेख नहीं था कि यह मुख्य द्वार के पास था, तो वेल्डर एक मुखौटा में साइट के चारों ओर घूमेगा, खोज करेगा।

  
  

• व्यक्तिगत संचार में, ट्री व्यू के कार्यान्वयन के बारे में एक प्रश्न

  
  

यह दिखाया गया है कि मुझे कौन सा तत्व है (प्लस साइन ... अच्छा है, विस्तार बटन बेहतर अनुवाद करें :)), संदर्भ दिखाई दे रहा है (नए स्क्रीन का स्क्रीन)

• DPI = 125% पर डैशबोर्ड डेमो स्केलिंग के साथ समस्या
  
  यह देखा जा सकता है कि किस प्रकार का ब्राउज़र और साइट URL है
  टैब अनावश्यक रूप से धुंधले होते हैं, ताकि विचलित न हों। विंडोज 10 क्रिएटर्स अपडेट के बारे में एक लेख छोड़ा गया था (जिसमें 125% डीपीआई 15.6) लैपटॉप पर एक डिफ़ॉल्ट बन गया) ताकि, इस स्क्रीनशॉट को देखकर मुझे यह याद रहे और इसके बारे में बात करने और दिखाने में सक्षम हो।

आइए फिर से जोर दें। सामान्य टूल के साथ, इनमें से प्रत्येक स्क्रीनशॉट के लिए तैयारी का समय 5 से 30 सेकंड तक है।
यह एक लंबी कलाकृति का फल नहीं है। यह तेज और कुशल है। आप रोक सकते हैं और उनमें से प्रत्येक को पूर्णता में ला सकते हैं ... लेकिन एक नियम के रूप में यह आवश्यक नहीं है।

स्क्रीनशॉट लेने के लिए कार्यक्रम

• Yandex.Disk, मुझे उसका स्क्रीनशॉट बहुत पसंद है। खैर, यहाँ यह है। किसी कारण से, यह सबसे अच्छा निकला जो मैंने तीर बनाने की कोशिश की, एक छोटे से वर्ग के साथ सर्कल और पठनीय शिलालेखों को जोड़ना। लेख के सभी उदाहरण इस पर बने हैं।
• मोनोसैप (मुफ्त, एक भुगतान योजना के साथ)। सिद्धांत रूप में, बहुत कुछ भी नहीं है, लेकिन (सब्जेक्टिविटी!) तीर बदसूरत हैं;
• शेयरएक्स (पूरी तरह से मुक्त);
• जिंग व्यापक रूप से हमारे तकनीकी सहायता इंजीनियरों द्वारा उपयोग किया गया है; धीरे-धीरे छोड़ना, क्योंकि वह एक बुरा फ्लैश में एक वीडियो लिखता है।
• विंडोज 10 में - अंतर्निहित संयोजन विन + शिफ्ट + एस # लेखक की टिप्पणी: वास्तव में काफी अच्छा है
• मैक # पर अंतर्निहित स्क्रीनशॉट
• ग्रीनशॉट - विन # , #
• लाइटशॉट - मैक / विन #
• फास्टस्टोन कैप्चर #
• फ्लेमशॉट (लिनक्स, गीथब पर विंडोज की संभावना पर चर्चा)
• स्निपिंग टूल - विंडोज # में निर्मित
• Gooncam #
• PicPick (विंडोज) #
• तमाशा और KSnapshot (लिनक्स) #
• समस्या चरण रिकॉर्डर - विंडोज में बनाया गया, कमांड लाइन से PSR के माध्यम से लॉन्च किया गया

हम समस्या को लिखते हैं, समाधान नहीं

यह आइटम आंतरिक चर्चा के परिणामस्वरूप उत्पन्न हुआ। बहुत अप्रत्याशित रूप से, यह सभी के लिए स्पष्ट नहीं था, इसलिए - एक उदाहरण।

उदाहरण के लिए, मैं एक डैशबोर्ड डिज़ाइनर का परीक्षण कर रहा हूँ और मुझे ऐसी चीज़ दिखाई दे रही है:

और मैं एक बग लिख रहा हूं:
"कोई क्षैतिज स्क्रॉल नहीं है"
मैं इसे चरणों और अपेक्षित परिणाम के साथ भी लिख सकता हूं: स्माइली:
अपेक्षित परिणाम : नियम का नाम क्षैतिज रूप से स्क्रॉल किया जाना चाहिए।
वास्तविक परिणाम : नियम का नाम स्क्रॉल नहीं है

बग को सामान्य रूप से तैयार किया गया है, लेकिन यह डेवलपर को मुझे मूर्ख मानने से नहीं रोकता है। और वह सही हो जाएगा :)

समस्याएं हैं: "पाठ अपनी संपूर्णता में दिखाई नहीं दे रहा है; पाठ आइकन पर आरोपित है"
लेकिन इस समस्या को दर्ज करने के बजाय, मैंने इस समस्या का समाधान रिकॉर्ड किया। कई में से एक, और निश्चित रूप से सबसे अच्छा नहीं है।
और ऐसा प्रतिस्थापन शायद ही कभी होता है। यहां तक ​​कि खुद भी, मैं कभी-कभी इस पर पकड़ करता हूं।
आखिरकार, मुझे पता है कि इसे कैसे ठीक किया जाए। इसलिए, मैं इसे लिखूंगा!
(खैर, कभी-कभी मैं वास्तव में जानता हूं। और मैं बग के शरीर में अपने सुझाव लिखने की कोशिश करता हूं, वास्तव में समस्या का वर्णन करने के बाद। लेकिन केवल संभव समाधान के रूप में नहीं)

प्लेबैक के लिए प्रो उदाहरण

डेस्कटॉप डेवलपमेंट में, यह आइटम डिबेटेबल है। एक ओर, उदाहरण कोड को निष्पादित करने की उपयोगिता जो समस्या को पुन: उत्पन्न करती है, सभी के लिए स्पष्ट है।
दूसरी ओर, एक उदाहरण बनाने से पहले ही बग को लिखने का समय काफी बढ़ जाता है, एक ऑर्डर तक।
सामान्य तौर पर, मेरे सिर में इस तरह से: जटिल मामलों के लिए यह आवश्यक है, साधारण मामलों में यह बेमानी हो सकता है।
मुझे विश्वविद्यालय में सिखाया गया था कि यदि सुरक्षा प्रणाली बहुत जटिल हो जाती है और नुकसान और असुविधा लाती है, तो वे बस इसका उपयोग करना बंद कर देते हैं।
यदि आप प्रत्येक बग के लिए बनाए जाने वाले एक उदाहरण की पुष्टि करते हैं, तो एक महीने में वे जटिल कीड़े के लिए भी उदाहरण देंगे)
दूसरी ओर, साधारण कीड़े पर आप उदाहरण बनाने के लिए प्रशिक्षित कर सकते हैं ...
संक्षेप में, यह मुद्दा बहस का मुद्दा है।

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

जूलियन द्वारा सरल उदाहरण कार्यक्रमों 10 के लिए एक अनुरोध

और सरलीकृत उदाहरणों के साथ ऐसा क्षण है, उद्धरण:

एक अत्यधिक सरलीकृत उदाहरण निश्चित रूप से अच्छा है, लेकिन बुरा भी है। ऐसे मामलों को दोहराया गया है जो एक सरल उदाहरण हैं:
- बग के सभी परिदृश्यों को कवर नहीं करता है;
- वास्तविक परिदृश्य को प्रतिबिंबित नहीं करता है, जिससे अनुचित समाधान हो सकता है।
आदर्श रूप से, एक सरलीकृत और मूल नमूना दोनों होना बेहतर है।

अब आप जानते हैं कि:

• उदाहरण तैयार करना बहुत उपयोगी है;
• यह मुश्किल है;
• मुख्य बात यह ज़्यादा नहीं है।

बग रिकॉर्ड समय

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

विपक्ष

जब मैं अपनी दृष्टि साझा करता हूं तो वे मुझे क्या कहते हैं:

बग स्पष्ट है

यह किसी ऐसे व्यक्ति के लिए स्पष्ट है जिसने पहले ही एक बिल्ली पा ली है।
एक विस्तृत विवरण और चरणों के बिना, बाकी सभी को उसके लिए देखना होगा। गैर-निर्धारक समय।
हां, मेरी पत्नी और वाययुचेव ने पहले तीन सेकंड में बिल्ली को पाया। मेरे दो नमूने।
और बाकी लोग (लगभग एक दर्जन या तो), जिनकी निगरानी मैंने देखी, पाँच मिनट तक एक बिल्ली को देखा।
लेकिन सामान्य तौर पर, मैंने थूक दिया और तुरंत एक अनुमान खोला।
और बुरी तरह से लिखा कीड़े के साथ।

वीडियो पर्याप्त है, वहां सब कुछ दिखाई दे रहा है

सबसे पहले, बग के पाठक के लिए यह एक लंबा समय है। कीवर्ड्स के लिए इसे क्रॉल करते हुए, स्टेप्स की सूची को पढ़ने से ज्यादा लंबा है।

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

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

(निष्पक्षता में, यह मेरे व्यवहार में हुआ कि कार्यात्मक के लेखक ने संलग्न वीडियो पर अन्य कीड़े पाए)

बहुत लंबे समय के लिए इस तरह कीड़े लिखें

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

संदर्भ

कीड़े की रिकॉर्डिंग के लिए आवश्यकताओं की सूची मेरे आधार पर पैदा हुई थी:

• बग रिपोर्ट लेखन दिशानिर्देश (मोज़िला); (मंच पर इस लिंक पर बहुत कम संक्रमण थे, लेकिन व्यर्थ में, एक उत्कृष्ट लेख :));
• स्मार्ट तरीके से प्रश्न कैसे पूछें 10 । एक सहकर्मी ने इस लेख को पहले विकल्प पर एक टिप्पणी के रूप में फेंक दिया, इसे खुशी के साथ पढ़ें:

यदि आप फ़ोरम-मालेइस्ट-ओपन-सोर्स बारीकियों को बाहर निकालते हैं, तो लगभग सब कुछ मूल्यवान है। मेरे पसंदीदा "समस्या के लक्षणों का वर्णन करें, न कि आपके अनुमानों का वर्णन करें" और "अपने प्रश्न के बारे में स्पष्ट रहें";

• और स्टैक ओवरफ्लो से - मैं एक अच्छा सवाल कैसे पूछूं ;
• इंटरनेट का अनुभव
• व्यक्तिगत अनुभव और कई वर्षों का दर्द।

अंत

मैंने अपनी टीमों के साथ बग दर्ज करने के बारे में यह राय साझा की। अब मैंने व्यापक दर्शकों तक पहुंचने का फैसला किया।

पढ़ने के लिए धन्यवाद।

यहां बिल्ली की तस्वीर ( यहां ली गई ) का सुराग मिला है।
वैसे, चित्र मेरा नहीं है, लेकिन अच्छी तरह से तैयार है - एक तीर है, और इसके साथ क्षेत्र में वृद्धि हुई है एक बग बिल्ली।

UPD 06/28/2019
सामान्य सूची में जोड़े गए टिप्पणियों के स्क्रीनशॉट कार्यक्रम
टाइपोस तय, यहां तक ​​कि टिप्पणियों में चर्चा का कारण बना