Uploaded avatar of iHiD

योगदान के नए दिशानिर्देश

@iHiD
लगभग 3 साल पहले

अगर आपको किसी अपने आप बंद हो चुके इश्यू या PR से यहाँ भेजा गया है, तो घबराइए नहीं और यह मत मानिए कि आपको नकार दिया गया है। ज़्यादातर मामलों में आपने जो भी काम किया है वह आगे चलकर Exercism में शामिल हो जाता है, या आपकी समस्या हल हो जाती है। हम योगदान का स्वागत करते हैं और लोगों को इसके लिए प्रोत्साहित करते हैं, लेकिन GitHub पर कोड लिखना शुरू करने से पहले हम अपने फोरम पर बात करना पसंद करते हैं। फोरम पर एक थ्रेड खोलने से काम आगे बढ़ेगा।


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

लेकिन मुझे यह भी पता है कि इससे उन नए कंट्रिब्यूटरों को निराशा हुई है जो मदद करने के लिए पूरी तरह तैयार हैं, पर हमारी योगदान प्रक्रिया से रुके हुए महसूस करते हैं। इसलिए आज मैं कुछ नए (या साफ किए गए) दिशानिर्देश सामने रखना चाहता हूँ, जिनसे पता चलेगा कि अगले कुछ महीनों में हम योगदान को किस तरह आगे बढ़ाएँगे।

सबसे बुनियादी नियम यह समझना ज़रूरी है कि हम विचारों, बग और इश्यू पर अपने फोरम पर बात करते हैं, और कोड में उससे होने वाले बदलावों पर GitHub पर (PR रिव्यू में) बात करते हैं। दूसरा नियम यह है कि (उन मेंटेनरों को छोड़कर जो स्वायत्त हैं) हम कोई काम करने से पहले उस पर बात करते हैं। हमारा फोरम अलग-अलग ट्रैक के कंट्रिब्यूटरों और मेंटेनरों को मौका देता है कि वे ढेरों भाषाओं और विचारों पर अपना ज्ञान और अनुभव साझा कर सकें, बिना GitHub पर 300 अलग-अलग रिपॉज़िटरी सब्सक्राइब किए और बिना अपने नोटिफिकेशन का बोझ बढ़ाए।

नए दिशानिर्देश

मदद लेना

  • अगर अभ्यास हल करने से पहले आप किसी भी चीज़ पर अटक जाएँ (जैसे CLI इंस्टॉल करना, टेस्ट चलाना, या अभ्यास के तर्क या ज़रूरतों पर अटक जाना), तो हमारे पास मदद के दो रास्ते हैं: फोरम पर हमारी "Exercism Support" श्रेणी, और हमारे Discord सर्वर का #get-help चैनल।
  • मदद माँगने के लिए हम GitHub या ईमेल का इस्तेमाल नहीं करते।
  • अगर आपने कोई अभ्यास हल कर लिया है, पर उसके बारे में सवाल हैं, तो आपको Exercism पर ही मेंटरिंग का अनुरोध करना चाहिए।

बग और इश्यू की रिपोर्ट करना

  • सारे बग और इश्यू हमारे फोरम पर खोलने चाहिए, जहाँ बहुत से लोग समस्या को समझने और हल करने में मदद कर सकते हैं।
    • अगर इश्यू किसी भाषा से जुड़ा है, तो उससे जुड़ी Programming/xxx श्रेणी का इस्तेमाल कीजिए।
    • अगर यह वेबसाइट पर कोई बग है, तो "Bugs & Feature Requests" श्रेणी का इस्तेमाल कीजिए।
  • GitHub इश्यू आम तौर पर अपने आप बंद कर दिए जाएँगे और जिसने इश्यू खोला है उसे फोरम पर भेज दिया जाएगा (साथ में एक क्लिक वाला लिंक, जिससे वह अपना इश्यू कॉपी/पेस्ट कर सके, जैसा अभी होता है)।
  • ट्रैक मेंटेनर चाहें तो ऑटो इश्यू-क्लोज़र बंद कर सकते हैं, पर आधिकारिक रास्ता फिर भी फोरम ही है।

Pull Request खोलना

  • कोई काम शुरू करने से पहले Pull Request पर फोरम पर बात होनी चाहिए।
  • जो लोग हमारे GitHub ऑर्गनाइज़ेशन के सदस्य नहीं हैं, उनके Pull Request पहले की तरह अपने आप बंद हो जाएँगे, पर फोरम पर बात हो जाने के बाद उन्हें अकसर दोबारा खोल दिया जाएगा। अगर PR के पीछे का विचार पहले ही स्वीकृत हो चुका है, तो उससे जुड़े फोरम थ्रेड में PR का लिंक जोड़ दीजिए, हम उसे दोबारा खोल देंगे।
  • ट्रैक मेंटेनर चाहें तो ऑटो PR-क्लोज़र बंद कर सकते हैं, पर हमारी सलाह है कि सभी PR पर पहले फोरम के ज़रिए बात हो।

सारांश

हमारी पहली प्राथमिकता आज भी यही है कि हमारे कोर कंट्रिब्यूटरों का समय और मानसिक ऊर्जा बची रहे, क्योंकि उनके बिना Exercism काम नहीं कर सकता। पर हम यह भी चाहते हैं कि Exercism ऐसी जगह बनी रहे जहाँ नए लोग बहुत कड़ी रुकावटों के बिना जुड़ सकें, और जहाँ हम उन लोगों को खुद कोर कंट्रिब्यूटर बनने के लिए प्रोत्साहित और समर्थन दे सकें!

मैं यह देखने के लिए उत्सुक हूँ कि आने वाले कुछ महीनों में ये बदलाव हमें मिलने वाले योगदानों पर कैसा प्रभाव डालते हैं। हम 2024 के मध्य में इन चीज़ों की फिर से समीक्षा करेंगे।

02 नवंबर 2023 · क्या यह काम की लगी?