अगर आप Exercism में योगदान देना चाहते हैं, तो धन्यवाद!
पुल रिक्वेस्ट बनाने से पहले कृपया एक शानदार पुल रिक्वेस्ट कैसे बनाएँ गाइड पढ़ लीजिए। इस गाइड का उद्देश्य पुल रिक्वेस्ट के गैर-तकनीकी पहलू में आपकी मदद करना है, ताकि आपको अच्छा अनुभव मिले और साथ ही हमारी मेंटेनर टीम को भी मदद पहुँचे।
इस दस्तावेज़ में अलग-अलग तरह के पुल रिक्वेस्ट के लिए कुछ अतिरिक्त दिशानिर्देश दिए गए हैं, जो खास Exercism के लिए हैं।
अभ्यास के पुल रिक्वेस्ट
इस तरह के अभ्यासों के आसपास बहुत सारे नियम होते हैं, इसलिए कॉन्सेप्ट अभ्यास या प्रैक्टिस अभ्यास के लिए पुल रिक्वेस्ट बनाना मुश्किल लग सकता है।
इसी वजह से एक मेंटेनर को समीक्षा करने में दो से तीन घंटे तक लग सकते हैं, और दर्जनों टिप्पणियाँ आ सकती हैं।
आपकी मदद के लिए आपके पुल रिक्वेस्ट पर एक मुख्य समीक्षक टिप्पणी करेगा।
समीक्षा की टिप्पणियों की संख्या देखकर हिम्मत न हारिए। किसी अभ्यास को कई बार दोबारा लिखने के बाद ही ऐसा रूप मिलना बिल्कुल सामान्य है, जिससे आप भी खुश हों और मुख्य समीक्षक भी।
सुझाव
इस प्रक्रिया को और आसान बनाने के लिए यहाँ कुछ सुझाव दिए गए हैं।
डॉक्यूमेंटेशन पढ़िए
किसी अभ्यास का पुल रिक्वेस्ट बनाने से पहले कॉन्सेप्ट अभ्यास का डॉक्यूमेंटेशन और प्रैक्टिस अभ्यास का डॉक्यूमेंटेशन ज़रूर पढ़ लीजिए।
पहले से डॉक्यूमेंटेशन पढ़ लेने से बहुत फायदा होता है: समीक्षा में टिप्पणियाँ कम आती हैं और आपका पुल रिक्वेस्ट कहीं जल्दी मर्ज हो जाता है।
मौजूदा अभ्यास देखिए (अगर हों)
अगर ट्रैक में पहले से कुछ अभ्यास मौजूद हैं, तो उन्हें थोड़ा समय देकर देखिए कि वे कैसे दिखते हैं और उनकी बनावट कैसी है।
प्रैक्टिस अभ्यास के पुल रिक्वेस्ट
सोचिए कि बदलाव वाकई problems-specifications में होना चाहिए या नहीं
प्रैक्टिस अभ्यास की कुछ सामग्री (जैसे उसका परिचय) उसके (साझा) मेटाडेटा से आती है, जो problems-specifications रिपॉज़िटरी में तय किया गया है।
अगर आप ऐसी सामग्री बदलना चाहते हैं, तो सोचिए कि इस बदलाव से दूसरे ट्रैक्स को भी फायदा हो सकता है या नहीं।
अगर हाँ, तो कृपया उस अभ्यास के मेटाडेटा में बदलाव के लिए problems-specifications रिपॉज़िटरी में पुल रिक्वेस्ट खोलिए।
सामान्य सुझाव
बिना माँगी गई समीक्षा न कीजिए
ट्रैक के पुल रिक्वेस्ट की सारी समीक्षाएँ ट्रैक के एक या एक से अधिक मेंटेनर करते हैं, क्योंकि रिपॉज़िटरी में हुए सारे बदलावों को मंज़ूरी देने की ज़िम्मेदारी उन्हीं की है।
समीक्षा मेंटेनर के हाथ में रहने से पुल रिक्वेस्ट के लेखक को आपस में टकराने वाला फीडबैक मिलने से भी बचाव होता है।
बेशक, आप समीक्षा में मदद देने के लिए टिप्पणी छोड़ सकते हैं (खासकर बड़े पुल रिक्वेस्ट में), या अगर आपको कुछ गलती जैसा लगे तो सवाल उठा सकते हैं।
