Lorawan-stack: प्रश्नों के लिए टेम्पलेट जारी करें

तो "कार्रवाई" यह होगी कि हम इस मुद्दे को संदर्भित करते हुए सीधे दस्तावेज़ीकरण को अपडेट करते हैं (यदि यह एकमात्र परिवर्तन है) और यदि यह बग फिक्स/फीचर अनुरोध में परिणाम देता है तो दूसरा खोलें?

बिल्कुल। एक "प्रश्न" समस्या का परिणाम आमतौर पर हमारे दस्तावेज़ीकरण में परिवर्तन, या हमारे अक्सर पूछे जाने वाले प्रश्नों के अतिरिक्त होना चाहिए।

मुझे नहीं पता कि किसी "प्रश्न" समस्या को "बग_रिपोर्ट" समस्या में कॉपी-पेस्ट करना समझ में आता है या नहीं। यदि हम किसी प्रश्न को बग रिपोर्ट या सुविधा में बदलने का निर्णय लेते हैं, तो हो सकता है कि हमें टिप्पणियों में संबंधित अनुभागों को जोड़ना चाहिए (या समस्या को संपादित करना चाहिए)।

सहमत हूं लेकिन वह भी मंच पर लागू होना चाहिए और सुस्त होना चाहिए।

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

"क्या आपने वहां देखा" की सूची के बजाय, मैं जिथब/डॉक पर एक क्वेरी के लिए एक लिंक जोड़ूंगा (एक बार खोज impl है)। जिथब मुद्दों में जानकारी की तलाश करना कठिन हो सकता है और फोरम में जानकारी/स्पष्टीकरण नहीं होना चाहिए जो दस्तावेज़ के पास नहीं है। पहले से स्थापित क्वेरी (जैसे बग की तलाश) का लिंक मदद करेगा। डॉक्स में बग की जानकारी रखने वाले सेक्शन को जोड़ने पर भी विचार किया जा सकता है।

यदि कोई प्रश्न बग पर प्रकाश डालता है तो यह बग के रूप में अर्हता प्राप्त करने के लिए देव पर निर्भर है (और समस्या को बग रिपोर्ट के रूप में संपादित करें) या प्रश्न के एकमात्र भाग में बग शामिल होने पर कोई अन्य समस्या खोलें।

मैं पूरी तरह से सहमत हूं कि हमें फोरम और स्लैक की बेहतर निगरानी करनी चाहिए और (अच्छे) प्रश्नों को दस्तावेज़ीकरण सुधार (कम से कम v3 श्रेणी और लोरावन-स्टैक चैनल के लिए ) में @Sypheos आप कैसे देखेंगे कि व्यवहार में काम कर रहा है?

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

मुझे लगता है कि यह एक अच्छा विचार है। आइए इस मुद्दे का दायरा रखें और टेम्पलेट जारी करें वास्तव में एक नया प्रश्न है।

जहाँ तक दस्तावेज़ीकरण में सुधार की बात है, अर्थात् एक मंच पर अनौपचारिक उत्तर और स्लैक जिसे हम दस्तावेज़ीकरण का हिस्सा चाहते हैं, हम एक अतिरिक्त "दस्तावेज़ीकरण अनुरोध" समस्या टेम्पलेट पर विचार कर सकते हैं, जो न्यूनतम है; यह मूल रूप से दस्तावेज़ीकरण अंतर और लिंक का वर्णन करता है जहां जानकारी अब है यदि कोई है (यानी फोरम/स्लैक संदेश का लिंक)। लेकिन फिर, मेरे लिए, इस मुद्दे के दायरे से बाहर।

प्रश्न टेम्पलेट आईएमओ के लिए:
क्या ढूंढ़ रहे हैं / क्या करना है ?
आपने कहाँ देखा?
_किसी भी वेबपेज, मुद्दों, क्वेरी को फिर से जोड़ें जीथब, डॉक्स, फोरम का स्वागत है_
संतुष्ट क्यों नहीं था ?
_404 नहीं मिला एक वैध उत्तरदाता है_

लेबल: प्रश्न

यदि प्रश्न का उत्तर देने के लिए कोई संसाधन नहीं हैं, तो "दस्तावेज़ीकरण अनुरोध" समस्या खोलें।

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

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

संक्षेप में, आइए विचार करें;

• प्रश्नों की अनुमति बिल्कुल न दें, केवल "दस्तावेज़ीकरण अनुरोध" मुद्दे। प्रश्न अभी भी मान्य हैं, लेकिन केवल अगर यह वास्तव में दस्तावेज नहीं है अन्यथा यह वैध दस्तावेज अनुरोध नहीं है और हम इसे बंद कर देते हैं
• डॉक्स से सीधे प्रश्न (जब हमारे पास हों) और फ़ोरम

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

यदि कोई प्रश्न पूछना चाहता है तो वे सुस्त या मंच पर जाते हैं जहां कोर टीम या मॉडरेशन के लिए कोई व्यक्ति अपने प्रश्न को दस्तावेज़ पीआर/बग समस्या/सुविधा अनुरोध समस्या में बदल सकता है।

निर्णय: हम https://github.com/TheThingsNetwork/lorawan-stack/issues/890#issuecomment -507324845 के साथ जाएंगे। प्रश्न टेम्प्लेट जो फ़ोरम को निर्देशित करता है, और एक दस्तावेज़ीकरण अनुरोध टेम्प्लेट