किसी बग की शिकायत करें
- विकिमीडिया परियोजनाओं के बारे में तकनीकी जानकारी पाने के लिए m:Tech देखें।
- WMF स्थापनाओं के अलावा मीडियाविकि के बारे में तकनीकी जानकारी पाने के लिए Project:Support desk देखें।
इन दिशानिर्देशों में बताया गया है कि विकिमीडिया के टास्क ट्रैकर पर किस तरह से एक अच्छा बग रिपोर्ट या सुविधा का अनुरोध (एक टास्क) लिखा जाता है (अधिक जानकारी के लिए Phabricator देखें)। अच्छे से लिखे गए टास्क्स को आम तौर पर जल्दी सुलझाया जाता है। टास्क्स को अंग्रेज़ी में लिखना ज़रूरी है। अगर आपको अंग्रेज़ी में लिखना नहीं आता, Google Translate जैसे किसी मशीन अनुवाद उपकरण का इस्तेमाल करें।
त्वरित अनुशंसाएँ
- निर्दिष्ट रहें
- स्पष्ट रहें: समझाएँ कि 1) बग तक चरणानुसार किस तरह से पहुँचना है, इस तरह ताकि पाठक को समझने में कोई दिक्कत न हो, 2) असली स्वभाव कैसा होना चाहिए, 3) इसका वर्तमान स्वभाव कैसा है। अलग-अलग अनुभागों में
- एक टास्क पर सिर्फ एक बग या एक विशिष्ट सुविधा का अनुरोध डालें
- सारे संबंधित कड़ियाँ और उदाहरण दर्ज करें
कुछ करने से पहले
क्या आपको वह बग फिर से दिख रहा है?
सॉफ्टवेयर के एक हाल ही के संस्करण में वापस बग तक पहुँचने की कोशिश करें ताकि जाँचा जा सके कि इसे पहले ही सुलझा दिया गया है या नहीं। अगर बग विकिपीडिया जैसे किसी सॉफ्टवेयर पर है, आप test2.wikipedia.org पर सबसे नए सॉफ्टवेयर संस्करण पर परीक्षणित करके देख सकते हैं।
क्या किसी ने पहले ही बग की शिकायत की है?
विकिमीडिया के बग ट्रैकर के खोज बॉक्स की मदद से जाँचें कि बग की शिकायत या सुविधा का अनुरोध पहले से ही किया गया है कि नहीं। आप उन्नत खोज पृष्ठ की मदद से और उन्नत खोज भी कर सकते हैं।
अगर आप अनिश्चित हैं कि किसी बग को रिपोर्ट किया गया है कि नहीं, आपको बग की शिकायत कर देनी चाहिए। दो रिपोर्ट होना रिपोर्ट के न होने से बेहतर है।
क्या ये एक गैजेट/सदस्य स्क्रिप्ट की समस्या है?
कुछ समस्याएँ ऐसे सदस्य स्क्रिप्टों और गैजेट्स का इस्तेमाल करने का अंजाम होते हैं जिन्हें ज़रा सुधार की ज़रूरत है। एक गाइड मौजूद है जिसमें ऐसे कोड को पहचानने की विधि बताई गई है, जिसकी मदद से आप बग को रिपोर्ट करके अपना समय बर्बाद करने की जगह इसे ठीक कर सकते हैं।
Is it a caching issue?
Some issues relate to older cached HTML being served alongside newer JavaScript where the two are incompatible. To help determine if this is the cause it is helpful to purge the page, refresh the page and see if the issue persists and include this information in your bug report.
नए बग या सुविधा के अनुरोध को रिपोर्ट करना
अगर आपने किसी हाल ही के संस्करण में कोई बग पाया है और आपको लगता है कि किसी ने भी इसकी शिकायत नहीं की है:
- phabricator.wikimedia.org पर जाएँ।
- आपको लॉग-इन (या पंजीकरण) करना होगा अगर आपने यह काम पहले से ही नहीं किया है तो ("अपना खाता बनाएँ" देखें)।
- ऊपरी-दाए कोने में बुकमार्क बटन पर क्लिक करके "Report a Software Bug" (या सुरक्षा समस्या को रिपोर्ट करने के लिए "Report a Security Issue") चुनें।
- कम से कम इन फील्ड्स को भरें:
- Title (शीर्षक): एक छोटा एक वाक्य का सारांश जिसमें समस्या का विवरण है (आपका सुझाया गया हल नहीं)।
- अच्छा:
"Selecting gender is not functional on Special:Preferences" - बुरा:
"Software crashes"
- अच्छा:
- Description (विवरण): समस्या का पूरा विस्तार, और वह सारी जानकारी जो वर्तमान में आपके पास है। अगर यह नाकाफ़ी होता है, तो आपको अतिरिक्त जानकारी के साथ, बग तक पहुँचने की विधि माँगी जाएगी। इस फील्ड पर होने चाहिए:
- बग्स के लिए:
- बग तक पहुँचने का रास्ता: छोटा, पालन करने में आसान चरण जो वर्णित समस्या तक पहुँचा सकती है। कोई विशेष सेटअप चरण हो तो उसे भी दर्ज करें।
- उदाहरण:
Go to https://en.wikipedia.org with Internet Explorer version 10.0;Make sure you are logged in;Select "My Preferences" menu;Go to "Gender" and select female gender from box list;Click "Save" button.
- उदाहरण:
- वर्तमान स्वभाव: उपर्युक्त चरणों का पालन करने के बाद ऐप्लिकेशन ने क्या किया।
- उदाहरण:
"There is no female gender in front of my username."
- उदाहरण:
- असली स्वभाव: अगर बग न होता तो ऐप्लिकेशन को क्या करना चाहिए था।
- उदहारण:
"My gender is shown in front of my username."
- उदहारण:
- बग तक पहुँचने का रास्ता: छोटा, पालन करने में आसान चरण जो वर्णित समस्या तक पहुँचा सकती है। कोई विशेष सेटअप चरण हो तो उसे भी दर्ज करें।
- सुविधा के अनुरोधों के लिए:
- आपके लक्ष्य का एक विवरण, और आप ऐसा क्यों चाहते हैं। उदाहरणों के साथ समझाएँ, आपको क्या लगता है कि यह सुविधा क्या सुलझाएगी (असली समस्या); पर एक विशिष्ट हल की माँग न करें, क्योंकि इसे सुलझाने के दूसरे/बेहतर रास्ते भी हो सकते हैं। कोई सदस्य की कहानी बात को प्रकट करने का एक अच्छा तरीका हो सकता है।
- उदाहरण:
"As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
- उदाहरण:
- आपके लक्ष्य का एक विवरण, और आप ऐसा क्यों चाहते हैं। उदाहरणों के साथ समझाएँ, आपको क्या लगता है कि यह सुविधा क्या सुलझाएगी (असली समस्या); पर एक विशिष्ट हल की माँग न करें, क्योंकि इसे सुलझाने के दूसरे/बेहतर रास्ते भी हो सकते हैं। कोई सदस्य की कहानी बात को प्रकट करने का एक अच्छा तरीका हो सकता है।
- दूसरी ज़रूरी जानकारी भी दें, जैसे:
- वेब ब्राउज़र, त्वचाएँ, या कंप्यूटर सिस्टम जिनमें आपने समस्या का अनुभव किया है;
- एक या एकाधिक ऐसे पृष्ठों की कड़ियाँ जहाँ आपने बग देखा है; या
- क्या यह समस्या हर बार, कभी-कभी, विशिष्ट पृष्ठों, या फिर विशिष्ट मामलों में आता है।
- बग्स के लिए:
- लॉग फाइल या स्क्रीनशॉट अटैच करने के लिए (सुनिश्चित करे कि कोई निजी जानकारी नहीं दिखाई जा रही है) Description फील्ज के उपकरण बार पर Upload File बटन (बादल और तीर के निशान वाले) पर क्लिक करें।
- वे tags (परियोजना(एँ)) चुनें जहाँ आपको बग दिखा है:
- परियोजनाओं की मदद से ही डेवलपर सुलझाने के लिए बग ढूँढ़ते हैं। सही परियोजना(ओं) को पहचानने के लिए खोज फंक्शन (ऊपरी-दाए तरफ) का उपयोग करके इसका विवरण खोजें।
- उदाहरणस्वरूप, यह विकि सॉफ्टवेयर के लिए
MediaWiki-Generalपरियोजना हो सकता है, या किसी विकिमीडिया साइट पर कॉन्फिगरेशन में बदलाव के लिएMediaWiki-Generalहो सकता है (Selecting projects देखें)।
- Subscribers (सदस्य): अगर आपको ऐसे सदस्यों के बारे में पता जो इस टास्क के बारे में सूचनाएँ पाना पसंद करेंगे, आप उन्हें यहाँ जोड़ सकते हैं। वरना फील्ड को खाली छोड़ दें।
- Title (शीर्षक): एक छोटा एक वाक्य का सारांश जिसमें समस्या का विवरण है (आपका सुझाया गया हल नहीं)।
देखें कि आपका रिपोर्ट पूरा है कि नहीं, और "Create Task" बटन पर क्लिक कर दें। अब आपका रिपोर्ट डेटाबेस में होगा। इससे कोई रूचि रखने वाले आकर इसे देख सकते हैं और शायद वे इसपर काम भी करे।
टास्क की प्राथमिकता डेवलपर तभी सेट करेंगे जब वे टास्क पर काम करना चाहे (Setting priorities देखें)।
बस यही! मीडियाविकि और विकिमीडिया परियोजनाओं को बेहतर बनाने में मदद करने के लिए धन्यवाद!
जावास्क्रिप्ट बग को रिपोर्ट करना
- ये भी देखें: मददः टूटी हुई लिपियों का पता लगाएँ
गैजेट्स, सदस्य स्क्रिप्ट, और मीडियाविकि के कुछ हिस्सों जैसे कई कार्य जावास्क्रिप्ट पर निर्भर हैं।
जब आपको ऐसा बग दिखे जो कि जावास्क्रिप्ट से संबंधित हो सकता है, त्रुटि संदेशों को पहचानकर उन्हें बग रिपोर्ट में दर्ज करने की कोशिश करें।
आपको ज्ञात पूरी जानकारी प्रदान करना भी ज़रूरी है, क्योंकि सिस्टम प्रबंधक भी त्रुटि के किसी लॉग तक नहीं पहुँच पाएँगे।
अगर समस्या सदस्य स्क्रिप्ट या गैजेट के कोड में ही है, शायद समस्या को सुलझाने के लिए Phabricator सही जगह नहीं है।[1] कुछ लोग शायद आपको स्क्रिप्ट के वार्ता पृष्ठ पर वापस भेज देंगे (अगर समस्या को उत्पन्न करने वाले स्क्रिप्ट का पता चलता है)।
कनेक्शन में समस्या को रिपोर्ट करना
अगर आपको विकिमीडिया वेबसाइट से कनेक्ट करते समय समस्याएँ आ रही हैं (धीमा इंटरनेट कनेक्शन, आदि), कृपया https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue का पालन करें।
लॉग-इन में समस्या को रिपोर्ट करें
अगर आपको अपने खाते में लॉग-इन करने में मुश्किलें आ रही हैं, कृपया Manual:How to debug/Login problems का पालन करें।
टिप्पणियाँ