README.hi.md

प्रथम योगदान

इस परियोजना का उद्देश्य शुरुआती लोगों द्वारा अपना पहला योगदान देने के तरीके को सरल और मार्गदर्शन करना है। यदि आप अपना पहला योगदान देना चाहते हैं, तो नीचे दिए गए चरणों का पालन करें।

आर्टिकल्स पढ़ना और ऑनलाइन ट्यूटोरियलज़ देखना मददगार साबित हो सकते हैं मगर बिना कुछ गलती करे खुद वो काम करने से अच्छा क्या हो सकता है? यह प्रोजेक्ट आपको आपके पहले कॉन्ट्रिब्यूशन के लिए दिशा निर्देशन में मदद करेगा । याद रखिये - जितने तनाव मुक्त होकर आप सीखेंगे उतना ही बेहतर सीख पाएंगे । यदि आप अपनी पहली कॉन्ट्रिब्यूशन करना चाहते हैं तो नीचे दिए गए निर्देशों का पालन करें ।

यदि आपके कंप्यूटर पर Git नहीं है तो, इसे स्थापित करें ।

यदि आप कमांड लाइन के साथ सहज नहीं हैं, तो यहाँ ग्राफिकल इंटरफेस (GUI) टूल्स का उपयोग करने वाले ट्यूटोरियल हैं ।

रिपॉज़िटरी को फॉर्क करना

काँटा (फॉर्क) बटन पर क्लिक करके इस रिपॉज़िटरी को फॉर्क कर सकते हैं। यह आपके GitHub खाते (अकाउंट) में इस रिपॉज़िटरी की एक प्रति (कॉपी) बना देगा जो केवल आपके लिए उपलब्ध होगी।

रिपॉज़िटरी को क्लोन करना

अब आप यह रिपॉज़िटरी अपने कंप्यूटर में क्लोन (अर्थात् डाउनलोड) करें । अपने GitHub अकाउंट पर जाएँ, फोर्कड रिपोजिटरी खोलें, Code/कोड बटन पर क्लिक करें और फिर copy to clipboard आइकॉन पर क्लिक करें ।

अपने कंप्यूटर पर एक टर्मिनल/कमांड प्रांप्ट खोलें और निम्न git आदेश (कमांड) चलाएँ:

git clone "यूआरएल जिसे आपने अभी कॉपी किया"

जहाँ "यूआरएल जिसे आपने अभी कॉपी किया" (उद्धरण चिह्नों के बिना) इस रिपॉज़िटरी के लिए यूआरएल है (इस परियोजना का आपका फॉर्क) । यूआरएल प्राप्त करने के लिए पिछले चरण देखें ।

उदाहरण के लिए:

git clone https://github.com/यह-आप-हैं/first-contributions.git

यह-आप-हैं आपके GitHub अकाउंट का नाम है। यहाँ आप अपने कंप्यूटर में GitHub से first-contributions रिपॉज़िटरी को कॉपी कर रहे हैं अथवा उसकी एक लोकल/स्थानीय कॉपी बना रहे हैं ।

एक शाखा (ब्राँच) बनाएँ

अपने कंप्यूटर पर बनाई गई रिपॉज़िटरी की कॉपी के फोल्डर/डायरेक्टरी में जाएँ (यदि अभी तक नहीं की है तो निम्न आदेश चलाएँ)

cd first-contributions

अब एक नई शाखा बनाएँ git switch कमांड का उपयोग करके । नई शाखा बनाने के लिए -c ऑप्शन का उपयोग होता है ।

git switch -c <अपनी-शाखा-का-नाम-जोड़ें>

उदाहरण के लिए:

git switch -c add-alonzo-church

( शाखा के नाम में add जोड़ने की आवश्यकता नहीं है, लेकिन इसमें शामिल होना जरूरी है क्योंकि इस शाखा का उद्देश्य एक सूची में अपना नाम जोड़ना है। )

आवश्यक परिवर्तन करें और उन परिवर्तनों को कमिट करें-

अब Contributors.md फ़ाइल को एक टेक्स्ट एडिटर में खोलकर इसमें अपना नाम लिखें। फ़ाइल की शुरुआत या अंत में इसे न जोड़ें। इसे बीच में कहीं भी रखें ।

आप यदि git status कमांड चलाएंगे , तो आप किये गए परिवर्तन देखेंगे।

उन परिवर्तनों को बनाई गई शाखा में जोड़ने के लिए git add कमांड का उपयोग करें ।

git add Contributors.md

अब अपने किये गए बदलावों को कमिट करें git commit कमांड का उपयोग करके ।

git commit -m "Add <आपका-नाम> to Contributors list"

<आपका-नाम> की जगह अपना नाम लिखें ।

अपने बदलावों को Github में पुश करें ।

git push का उपयोग कर अपने परिवर्तन को पुश करें ।

git push origin <अपनी-शाखा-का-नाम-जोड़ें>

<अपनी-शाखा-का-नाम-जोड़ें> की जगह अपनी शाखा का नाम लिखें ।

अपने बदलावों को रिव्यु के लिए सबमिट करें ।

यदि आप अपने Github प्रोफाइल पर अपनी रिपॉज़िटरी में जायेंगे तो आपको Compare & pull request का ऑप्शन दिखेगा। उसे दबाएं ।

अब अपनी pull request सबमिट करें ।

जल्द ही मैं आपके बदलावों को इस प्रोजेक्ट की मास्टर शाखा में मर्ज कर दूंगा। आपको एक मेल आएगी जब आपके बदलाव मर्ज होंगे ।

यहाँ से कहाँ जाएं ?

बधाई! आपने fork -> clone -> edit -> PR वर्कफ्लो की पूर्ति कर ली है, जिसका आप अक्सर एक योगदानकर्ता के रूप में सामना करेंगे!

अपने पहले योगदान की खुशी में जश्न मनाएं तथा इसे वेब एप्प के जरिये अपने मित्रों के साथ शेयर करें।

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

अब आप अन्य प्रोजेक्ट्स पर योगदान कर सकते हैं, तो चलिए शुरू करते हैं! हमने आपके लिए एक प्रोजेक्ट्स की सूचि तैयार की है जहाँ सरल इश्यूज हैं । आप चाहें तो वहाँ से आरम्भ कर सकते हैं । प्रोजेक्ट्स कि लिस्ट

शिक्षण अन्य साधनो का उपयोग करने के लिए

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree