README.hi.md

प्रथम योगदान

पहली बार कुछ करना कठिन होता है| ख़ास तौर पर जब आप मिलकर काम कर रहे हों तब गलतियां करना एक अच्छी बात नहीं है| मगर आपस में मिलना और एक जुट होकर काम करना ही तो है ओपन सोर्स| हम आपका ये पहला ओपन सोर्स कॉन्ट्रिब्यूशन आसान बनाने में आपकी मदद करेंगे|

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

अगर आपके मशीन पर Git नहीं है तो, इसे स्थापित करें

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

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

रिपोजिटरी क्लोन

अब आप यह रेपो अपने मशीन में क्लोन करें| अपने गिटहब खाते पर जाएं, क्लोन बटन पर क्लिक करें और फिर कॉपी टू क्लिपबोर्ड आइकॉन पर क्लिक करें|

एक टर्मिनल खोलें और निम्न git आदेश चलाएँ:

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

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

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

git clone https://github.com/यह-तुम-हो/first-contributions.git

यह-तुम-हो आपके GitHub अकाउंट का नाम है। यहाँ आप अपने कंप्यूटर में GitHub से फर्स्ट-कंट्रिब्यूशंज़ रेपो को आप कॉपी कर रहे हैं|

एक ब्राँच बनाएं

अपने कंप्यूटर पर रिपोजिटरी डायरेक्टरी में बदलें (अगर अभी तक नहीं की है तो)

cd first-contributions

अब एक शाखा बनाएं git checkout command उपयोग करके|

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

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

git checkout -b 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 सबमिट करें|

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

पुल अनुरोध मर्ज के बाद शाखा हटाएं

पुल अनुरोध मर्ज होने के बाद आप अपनी शाखा को सुरक्षित रूप से हटा सकते हैं। शाखा को हटाने के लिए आपको एक बटन दिखाई देगा:

अगर पुल अनुरोध मर्ज किए बिना बंद कर दिया गया था, तो github आपको मर्ज न किए गए कामों को हटाने के बारे में चेतावनी देगा और बटन इस तरह दिखेगा:

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

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

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

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

अब आप और प्रोजेक्ट्स में कंट्रीब्यूट करना शुरू कर सकते हैं| हमने आपके लिए एक लिस्ट बनायीं है जो कि बहुत आसान मुद्दे हैं| प्रोजेक्ट्स कि लिस्ट

अन्य टूल का उपयोग करके ट्यूटोरियल

GitHub Desktop	Visual Studio 2017	GitKraken

आत्म पदोन्नति

अगर आपको यह प्रोजेक्ट पसंद आया, तो इसे स्टार करें GitHub पर| यदि आप विशेष रूप से धर्मार्थ महसूस कर रहे हैं, तो follow Roshan twitter और GitHub पर|