Zenodo: वैश्विक: संपर्क फ़ॉर्म

क्या मैं इस एन्हांसमेंट को जोड़ने का प्रयास कर सकता हूँ...?

@ jainaman224 हाँ, यह वास्तव में हमारे समर्थन के लिए बहुत बड़ी मदद होगी :)

मुख्य विचार यह है कि आम समस्याओं के बारे में बहुत से लोग हमसे संपर्क करते हैं (zenodo.org - सेवा), जो आमतौर पर हैं:

• किसी रिकॉर्ड को हटाना या किसी फ़ाइल को कहीं रिकॉर्ड में अपडेट करना।
• उनके खाते से कुछ कर रहे हैं।
• किसी पृष्ठ पर त्रुटि प्राप्त करना (500s आदि)।

बहुत बार उनमें अधिक जानकारी शामिल नहीं होती (जैसे कि उल्लिखित OS, ब्राउज़र), और बहुत बार वे यह निर्दिष्ट नहीं करते कि वे किस रिकॉर्ड को हटाना/अपडेट करना चाहते हैं। कभी-कभी वे यह उल्लेख करना भूल जाते हैं कि उनका ज़ेनोडो ईमेल क्या है (और बहुत बार यह उस ईमेल से भिन्न होता है जिससे वे हमें लिख रहे हैं)।

मुख्य विचार यह होगा कि जितना संभव हो उतना जानकारी प्राप्त करें और शामिल करें और इसे फ़ॉर्म के माध्यम से हमें भेजें, इसलिए

1. मूल एजेंट जानकारी (ब्राउज़र, ओएस, आईपी) कैप्चर करें। और ईमेल के साथ भेजें।
2. यदि उपयोगकर्ता लॉग इन है तो उसे कैप्चर करें और ईमेल में अपना ईमेल + उपयोगकर्ता आईडी भेजें (फॉर्म को पहले लॉग-इन करने की अनुशंसा करनी चाहिए)।
3. टेक्स्ट-विवरण यह निर्दिष्ट करते हुए कि उन्हें कौन सी जानकारी शामिल करनी चाहिए:
   
   
   
   • यदि यह समस्या के लिए प्रासंगिक है तो URL या DOI रिकॉर्ड करें।
   
   
   • त्रुटि आईडी अगर उन्हें एक पृष्ठ से मिलती है (हम इसे आसानी से संतरी पर देख सकते हैं)
   
   
   • किसी पृष्ठ का URL जो उनके लिए क्रैश हो सकता है
   
   
   • गिटहब उपयोगकर्ता नाम/orgname/reponame अगर यह गिटहब से संबंधित है।
   
   

कार्य अंक 1 और 2 को लागू करना है, हम बाद में फॉर्म (बिंदु 3.) पर एक अच्छा पाठ के बारे में सोच सकते हैं।

यह फ़ॉर्म शायद हमें एक ईमेल भेजना चाहिए, जहाँ ईमेल के मुख्य भाग के निचले हिस्से में इस जानकारी के साथ एक पूर्व-स्वरूपित स्ट्रिंग शामिल हो सकती है।

क्या मुझे इस फॉर्म को लागू करने की आवश्यकता है https://zenodo.org/support ...?

वर्तमान "/ समर्थन" पृष्ठ बिना किसी रूप के केवल स्थिर जानकारी है - इसे अभी के लिए इसी तरह रहना चाहिए।

आपको एक नया पेज बनाना होगा (उदाहरण के लिए: "/support-form"), जहां आप GitHub के समान कुछ सरल संपर्क फ़ॉर्म को परिभाषित करेंगे: https://github.com/support

ज़ेनोडो में एक फॉर्म का एक उदाहरण यहां दिया गया है (यह विशेष रूप से व्यवस्थापक द्वारा रिकॉर्ड हटाने के लिए है):

खाका:
https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/templates/zenodo_deposit/delete.html

प्रपत्र:
https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/forms.py

राय:
https://github.com/zenodo/zenodo/blob/master/zenodo/modules/deposit/views.py#L142 -L211

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

तकनीकी सहायता, ज़ेनोडो नीतियां, आउटरीच, अन्य (श्रेणियां जिन्हें बाद में परिभाषित किया जाएगा)।

यह जानकारी भेजे गए ईमेल के उपसर्ग के रूप में जा सकती है:

"[तकनीकी सहायता]: शेष शीर्षक"

यह बेहतर होगा। :+1:

उपयोगकर्ता-एजेंट पार्सिंग के लिए https://github.com/ua-parser/uap-python का उपयोग

एक उपयोगकर्ता को यह देखने में सक्षम होना चाहिए कि हमें कौन सी जानकारी भेजी गई है (और शायद ऑप्ट-आउट करने में सक्षम हो)

@lnielsen क्या बुनियादी ढांचे को मंजूरी मिलने के बाद क्या मैं इसे बाद में शामिल कर सकता हूं ...?

कुछ सामान्य सुधारों के अलावा @ jainaman224 द्वारा पीआर पहले से ही वास्तव में अच्छा लग रहा है: https://github.com/zenodo/zenodo/pull/1008

इस सुविधा को उत्पादन के लिए तैयार करने के लिए कुछ और बदलावों की आवश्यकता है:

• [ ] uap-python प्रयोग करें
• [ ] फॉर्म के दो प्रकार होने चाहिए।
  
  
  
  • यदि आप लॉग-इन हैं, तो इसे पहले से भरना चाहिए और प्रदर्शित करना चाहिए:
  
  
  • [x] Name (उपयोगकर्ता के पूरे नाम के साथ पहले से भरा हुआ टेक्स्ट-फ़ील्ड - उपयोगकर्ता द्वारा संपादन योग्य)
  
  
  • [x] Email (केवल एक लेबल) यह कहते हुए कि "ज़ेनोडो कर्मचारी आपके ज़ेनोडो ईमेल द्वारा आपसे संपर्क करेंगे: [email protected] " (संशोधित नहीं)
  
  
  • यदि आप लॉग-इन नहीं हैं:
  
  
  • [x] Name (खाली टेक्स्ट-फ़ील्ड)
  
  
  • [x] Email (खाली टेक्स्ट-फ़ील्ड)
  
  
• [x] रीकैप्चा परीक्षण ताकि हमें स्पैम न मिले
• [x] प्रपत्र में उपयोगकर्ता-एजेंट जानकारी प्रदर्शित होनी चाहिए जो उपयोगकर्ता से भेजी जाएगी, अर्थात:

To better address your problem, the following information can be sent to us (recommended) alongside with your message:
Operating system: ...
Browser: ...
(more User-Agent info)

उसके आगे एक चेकबॉक्स होना चाहिए (डिफ़ॉल्ट रूप से सक्षम) "[x] ब्राउज़र और सिस्टम जानकारी भेजें।"

• [x] श्रेणी इस तरह से config.py में विन्यास योग्य होनी चाहिए:

PAGES_SUPPORT_CATEGORIES = [
 ('Technical Support', "Please describe the error you are getting, include any error messages or link to screenshots which might be relevant"),
 ('File upload request', "Please include the URL of the updated file, and specify which record and file you want to replace. Please use publicly accessible URLs."),
 (...)
]

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

• [ ] श्रेणी को विकल्पों के बीच एक सहज संक्रमण दिखाना चाहिए, आदर्श रूप से बिना बहुत अधिक (यदि कोई हो) कस्टम जावास्क्रिप्ट, उदाहरण के लिए यह बूटस्ट्रैप तत्व: http://getbootstrap.com/javascript/#collapse

• [ ] ईमेल सफलतापूर्वक हमें भेजे जाने के बाद उपयोगकर्ता को एक पुष्टिकरण ईमेल भेजा जाना चाहिए।
  इस तरह के उपयोगकर्ता को हमसे एक प्रश्न पूछने और फिर उत्तर नहीं मिलने से रोकता है क्योंकि फॉर्म हमें किसी कारण से अपना संदेश नहीं भेजता है। फ़ॉर्म पर यह बताया जाना चाहिए कि उसे 20 मिनट के भीतर अपने इनबॉक्स पर एक पुष्टिकरण ईमेल प्राप्त होना चाहिए - यदि नहीं, तो उसे पुनः प्रयास करना चाहिए या हमें सीधे [email protected] पर एक ईमेल भेजना चाहिए।

• [ ] संदेश के साथ फाइल अपलोड करना संभव होना चाहिए, जो हमें ईमेल अटैचमेंट के रूप में भेजा जाना चाहिए। फ़ाइल में URL शामिल करने का सुझाव देने वाली बड़ी फ़ाइलों के लिए अधिकतम फ़ाइल आकार विन्यास योग्य और प्रदर्शन त्रुटि होनी चाहिए। इसे कहीं भी संग्रहीत नहीं किया जाना चाहिए, लेकिन आवेदन (स्मृति) के माध्यम से पारित किया जाना चाहिए और सीधे एक कार्य में ईमेल अनुलग्नक के रूप में भेजा जाना चाहिए।

  • [ ] वर्तमान में सेलेरी के साथ फ़ाइल क्रमांकन मुद्दों के कारण वेबएप प्रक्रिया में भेजें। कच्चे बाइट्स और फ़ाइल नाम भेजकर और फिर फ़ाइल ऑब्जेक्ट को कार्य के अंदर इकट्ठा करके तय किया जाना चाहिए।
  • [ ] भेजने के लिए कई फाइलों का चयन करना संभव होना चाहिए।
  • [ ] जांचें कि क्या हम कुछ अच्छे ड्रैग-एंड-ड्रॉप फ़ाइल चयनकर्ता विजेट का उपयोग कर सकते हैं।

• [ ] फॉर्म में कुछ स्टाइल और सामग्री पर काम करने की आवश्यकता होती है (पाठ/विवरण/चुनने के लिए मुद्दों के प्रकार आदि)

• [ ] मॉड्यूल को पायथन लिंटर्स से जांचने की आवश्यकता है।

@ jainaman224 आपका योगदान पहले से ही एक अच्छी शुरुआत है, और मुझे पता है कि ये कुछ अतिरिक्त आवश्यकताएं हैं। यदि आप अभी भी रुचि रखते हैं तो इस पर काम करना जारी रखने के लिए आपका स्वागत है, लेकिन यह जान लें कि आपका पहला योगदान स्वीकार करना अनिवार्य नहीं है! :)

@lnielsen @krzysztof मुझे लगता है कि हमें उपयोगकर्ता से अधिक जानकारी की आवश्यकता नहीं है। तो, इस तरह से जाना बेहतर होगा https://github.com/jainaman224/zenodo/blob/patch-1/zenodo/modules/pages/views.py#L57 #L60। अगर मैं गलत हूं कृपया मुझे सही।
शुक्रिया

@lnielsen @krzysztof uap-python का उपयोग करना बेहतर क्यों है?