यह मार्गदर्शिका उन लोगों के लिए है जो समुदाय के लिए परियोजना के प्रबंधन और रखरखाव में सहायता के लिए अनुरक्षक के रूप में परियोजना में शामिल होना चाहते हैं। (यह पहली बार योगदान करने वालों के लिए मार्गदर्शिका नहीं है।)
यह ट्यूटोरियल अन्य भाषाओं में भी उपलब्ध है।
| अंग्रेज़ी | बांग्ला | जर्मन | इतालवी | जापानी |
|---|---|---|---|---|
| हिंदी | पुर्तगाली | यूक्रेनी | चीनी (पारंपरिक) |
प्रोजेक्ट दस्तावेज़ों के अनुवाद का स्वागत है। योगदान देने के लिए
अनुवाद गाइडपढ़ें।
हमारा मुख्य उद्देश्य अपने योगदानकर्ताओं को उनके पुल अनुरोध करने के बिंदु से यथासंभव त्वरित प्रतिक्रिया देना है। इसका मुख्य अर्थ है कोड समीक्षा देना और स्वीकृत पीआर का विलय करना। इसके अलावा, हम यह सुनिश्चित करते हुए परियोजना को बनाए रख सकते हैं कि सब कुछ सही ढंग से काम कर रहा है और यह हमारे योगदानकर्ताओं के लिए जितना उपयोगी और उपयोगी हो सकता है।
Git और GitHub कौशल वाला कोई भी व्यक्ति। आपको विशेषज्ञ होने की ज़रूरत नहीं है, इस मार्गदर्शिका से शुरुआती लोगों को भी मदद मिलेगी। यह एक सक्रिय प्रोजेक्ट है जिसमें नियमित योगदान मिलता है और यह कई लोगों को अपना पहला ओपन सोर्स योगदान देने में मदद करता है। इस परियोजना पर अनुरक्षक होने से यह सुनिश्चित करने में मदद मिलती है कि यह हमारे योगदानकर्ताओं को एक अच्छा पहला अनुभव देता रहे और उन्हें और अधिक योगदान देने के लिए प्रोत्साहित करता रहे।
आप इसमें जितना चाहें उतना अधिक या कम समय लगा सकते हैं। हमें उम्मीद है कि हम अपने बीच इसे सुचारू रूप से जारी रख सकेंगे।
- प्रोजेक्ट के पुल अनुरोध अनुभाग पर जाएं, सबसे पुराने पुल अनुरोध से शुरू करें जो 'परिवर्तन अनुरोध' स्थिति में नहीं है।
- एक पीआर खोलें और फ़ाइल परिवर्तन टैब पर जाएं और एक कोड समीक्षा शुरू करें।
- पीआर की जांच करें, सुनिश्चित करें कि यह ट्यूटोरियल में निर्दिष्ट विनिर्देशों का पालन करता है।
- सुनिश्चित करें कि HTML, लिंक और डेटा सभी सही हैं। सुनिश्चित करें कि कार्ड फ़ाइल के प्रारंभ में वहीं स्थित है जहाँ उसे होना चाहिए।
- किसी भी टकराव के लिए अगली जाँच करें। विवादों को ठीक करने के लिए
मास्टरको पीआर शाखा में मर्ज करें। टकराव आम तौर पर तब होता है जब पिछले विलय को काफी समय हो गया हो और कई पीआर उसी पुराने संस्करण का उपयोग कर रहे हों। - यदि ऐसा है तो विवाद को ठीक करें। आमतौर पर आपको उन कार्डों के ऊपर नया कार्ड जोड़ना होगा जो कांटा बनने के बाद जोड़े गए थे।
- यदि बाकी सब ठीक है, तो पीआर को मंजूरी दें, योगदानकर्ता को योगदान के लिए धन्यवाद देते हुए एक संदेश लिखें (याद रखें कि वे पहली बार आए हैं और प्रोत्साहन से लाभान्वित होंगे)।
- पीआर को
मास्टरमें मर्ज करें।
- कभी-कभी पीआर के साथ ऐसी समस्याएं होती हैं जिन्हें योगदानकर्ता द्वारा ठीक किया जाना चाहिए जैसे गलत ब्रांचिंग, टूटा हुआ HTML, गुम जानकारी, गलत जगह पर रखा गया कार्ड। कुछ भी जहां ट्यूटोरियल का सही ढंग से पालन नहीं किया गया (और साधारण मर्ज विरोध नहीं)।
- GitHub पर एक कोड समीक्षा प्रारंभ करें और परिवर्तनों का अनुरोध करें। यथासंभव वर्णनात्मक होने का प्रयास करें, सटीक पंक्ति पर टिप्पणी करें, उन्हें बताएं कि वास्तव में समस्या क्या है और इसे कैसे ठीक किया जाए, और उन्हें प्रोत्साहित करें कि यह पीआर समीक्षा प्रक्रिया का एक सामान्य हिस्सा है।
- जब आप तैयार हों तो समीक्षा सबमिट करें।
- यदि योगदानकर्ता के पास अनुवर्ती प्रश्न हों तो बातचीत पर नज़र रखें, जिसमें आप मदद कर सकते हैं। हमारा उद्देश्य हर किसी को अंतिम रेखा से आगे ले जाना है, इसलिए हम उन्हें वहां तक मार्गदर्शन करने का प्रयास करते हैं।
- एक बार जब वे अनुरोधित परिवर्तनों को ठीक कर लेते हैं, तो पीआर को
मास्टरमें विलय किया जा सकता है।
कृपया, हमेशा परीक्षण करें कि परिवर्तनों ने प्रोजेक्ट को बाधित नहीं किया है और लाइव पेज अभी भी अपेक्षा के अनुरूप काम करता है। विलय से पहले स्थानीय स्तर पर परिवर्तनों का परीक्षण करना हमेशा सर्वोत्तम होता है और जो भी संदिग्ध लगे उसे कभी भी विलय न करें।
यदि बहुत अधिक संचित पीआर नहीं हैं तो यह सारी प्रक्रिया सीधे प्रोजेक्ट के GitHub पेज में की जा सकती है।
हालाँकि, कुछ पीआर का इंतज़ार करना कोई असामान्य बात नहीं है और तभी अनिवार्य रूप से कुछ मर्ज टकराव होंगे। अंतर देखने और विरोधों को ठीक करने के लिए आप किसी भी परिचित उपकरण का उपयोग कर सकते हैं।
मैं GitKraken जैसे टूल के उपयोग की अनुशंसा करता हूं। यह दृश्यात्मक है और जब कुछ पीआर से गुजरना होता है तो यह परियोजना के आसान प्रबंधन की अनुमति देता है।
GitKraken डाउनलोड करें, प्रोजेक्ट क्लोन करें। अपने कोड संपादक और GitKraken के एकीकृत मर्ज संघर्ष उपकरण के संयोजन का उपयोग करने से आपको पीआर के माध्यम से जल्दी से जाने, विवादों को ठीक करने और विलय करने का पूर्ण नियंत्रण मिलता है।
प्रोजेक्ट में यह सुनिश्चित करने के लिए प्रीटियर स्थापित किया गया है कि चाहे योगदानकर्ता पीआर कैसे भी सबमिट करे, स्टाइल गाइड लागू किया जाएगा। इस तरह से प्रोजेक्ट को हमेशा एक ही इंडेंटेशन और शैली के साथ बनाए रखा जाता है।
यदि आप देखते हैं कि HTML फ़ाइल अस्त-व्यस्त दिख रही है, तो प्रोजेक्ट रूट में नीचे दिए गए कोड को चलाएँ।
npx prettier --write index.htmlइसे फ़ाइल को फ़ॉर्मेट करने का प्रयास करना चाहिए और यदि ऐसा नहीं हो पाता है तो यह आपको त्रुटियाँ दिखाएगा। कभी-कभी कोई गुम हुआ क्लोजिंग टैग या टूटा हुआ HTML गलती से मर्ज हो जाता है और यह उसे पहचानने और ठीक करने का एक अच्छा तरीका है। यदि आप कभी भी संदेह में हों, तो आप हमेशा पीआर में मेरा या अन्य अनुरक्षकों का उल्लेख कर सकते हैं या मुझे ट्विटर पर डीएम कर सकते हैं।
इस परियोजना को एक साथ आगे बढ़ाने में मदद करने के लिए हमसे जुड़ें। ट्विटर पर मुझसे संपर्क करें और मुझे अपना GitHub उपयोगकर्ता नाम भेजें ताकि मैं आपको जोड़ सकूं। आप नीचे दिए गए बटन पर क्लिक करके भी हमारे डिसॉर्डर समुदाय में शामिल हो सकते हैं: