README.hi.md

प्रथम योगदान

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

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

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

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

इस पृष्ठ(पेज) के शीर्ष(टॉप) पर स्थित फोर्क बटन पर क्लिक करके इस रिपॉजिटरी को फोर्क करें। यह आपके गीत-हब(Github) लेखा(अकाउंट) में इस रिपॉजिटरी की एक प्रति(कॉपी) बनाएगा।

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

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

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

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

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

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

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

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

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

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

cd first-contributions

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

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

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

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

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

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

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

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

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

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree