[![ओपन सोर्स को प्यार](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
[![लाइसेंस: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![ओपन सोर्स हेल्पर्स](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)

# First Contributions

|<img alt="Sublime Merge" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/sublime-merge.png" width="200">|Sublime Merge Git क्लाइंट|
|---|---|

यह मुश्किल है। पहली बार कुछ करते समय यह हमेशा मुश्किल होता है। खासकर जब आप सहयोग कर रहे हों या कुछ नया आजमा रहे हों, गलतियाँ करना आसान नहीं होता। लेकिन ओपन सोर्स सहयोग और टीमवर्क के बारे में है। हमने नए ओपन सोर्स योगदानकर्ताओं के लिए पहली बार सीखने और योगदान करने की प्रक्रिया को आसान बनाना चाहा।

लेख पढ़ने और ट्यूटोरियल देखने से मदद मिल सकती है, लेकिन बिना कुछ गड़बड़ किए वास्तव में चीजें करने से बेहतर और क्या हो सकता है? यह प्रोजेक्ट मार्गदर्शन प्रदान करने और नए योगदानकर्ताओं की पहली योगदान प्रक्रिया को सरल बनाने का लक्ष्य रखता है। याद रखें, जितने अधिक रिलैक्स्ड आप होंगे, उतना ही बेहतर आप सीखेंगे। यदि आप अपना पहला योगदान देना चाहते हैं, तो बस नीचे दिए गए सरल चरणों का पालन करें। हम वादा करते हैं, यह मजेदार होगा।

## Sublime Merge

[Sublime Merge](https://www.sublimemerge.com/) डाउनलोड करें, इंस्टॉल करें और खोलें।

## इस रिपॉजिटरी को फोर्क करें

इस पेज के ऊपर दिए गए फोर्क बटन पर क्लिक करके इस रिपॉजिटरी को फोर्क करें।
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/fork.png" alt="fork this repository" />
यह आपके अकाउंट में इस रिपॉजिटरी की एक कॉपी बना देगा।

<br>
<br>
<br>
<br>

## रिपॉजिटरी को क्लोन करें

<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/clone.png" alt="clone this repository" />

Sublime Merge में, फाइल -> क्लोन रिपॉजिटरी पर जाएं।

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/sm-clone.png" alt="clone this repository" />

अगला चरण आपकी रिपॉजिटरी को अपने कंप्यूटर पर क्लोन करना है ताकि आप बदलाव करना शुरू कर सकें। Sublime Merge को आपकी रिपॉजिटरी का URL चाहिए, इसलिए "क्लोन" बटन पर क्लिक करें और फिर "क्लिपबोर्ड पर कॉपी" आइकन पर क्लिक करें।

**ध्यान दें:** नए योगदानकर्ता अक्सर गलती से मूल रिपॉजिटरी को क्लोन कर लेते हैं _बजाय अपनी खुद की फोर्क की गई रिपॉजिटरी के_। अपने ब्राउज़र की एड्रेस बार चेक करें और सुनिश्चित करें कि आप अपनी खुद की रिपॉजिटरी क्लोन कर रहे हैं।

Sublime Merge में रिपॉजिटरी का URL पेस्ट करें, उसे एक रिपॉजिटरी नाम दें (या खाली छोड़ दें) और वह डायरेक्टरी सेट करें जहां रिपॉजिटरी सेव होगी।

पाथ से संतुष्ट होने के बाद, "क्लोन" पर क्लिक करें।

## ब्रांच बनाएं

Branches पर राइट-क्लिक करें -> नई ब्रांच बनाएं 
या 
रिपॉजिटरी -> नई ब्रांच पर जाएं

अपनी ब्रांच को "add-your-name" जैसा नाम दें, उदाहरण के लिए: "add-अन्ना-सोफिया"

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/sm-branch.png" alt="name your branch" />

## आवश्यक बदलाव करें और उन्हें कमिट करें

अब `Contributors.md` फाइल को टेक्स्ट एडिटर में खोलें और अपना नाम जोड़ें, फिर फाइल सेव करें।

अगर आपकी रिपॉजिटरी Sublime Merge में खुली है, तो आप देखेंगे कि कुछ बदलाव हुए हैं। 
सबसे ऊपर "x unstaged files" नाम की लेटेस्ट कमिट को चुनें
जिन फाइल्स में बदलाव हुए हैं उन्हें चेक करें और तय करें कि किन्हें स्टेज करना है। 
कमिट को एक मैसेज दें ("योगदानकर्ताओं की सूची में <आपका-नाम> जोड़ें" अच्छा और डिस्क्रिप्टिव लगता है)।
जब आप अपने बदलावों से संतुष्ट हों, तो फाइल-बाय-फाइल या "stage all" चुनकर इन बदलावों को स्टेज करके कमिट करें। स्टेजिंग महत्वपूर्ण है ताकि git को पता चले कि इस कमिट से किन फाइल बदलावों को जोड़ना है।

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/sm-stage.png" alt="stage your changes" />

अगर आप अपना मन बदलते हैं, तो आप इन बदलावों को अनस्टेज कर सकते हैं, या पूरी तरह से डिस्कार्ड भी कर सकते हैं।
चेतावनी: जैसा कि "डिस्कार्ड" शब्द से पता चलता है, यह एक डिस्ट्रक्टिव ऑपरेशन है। ऐसा केवल तब करें जब आप वर्तमान रिपॉजिटरी से कोई भी बदलाव नहीं रखना चाहते।

ऊपर बाईं ओर दिए गए "कमिट" बटन पर क्लिक करें। यह आपको आपके स्टेज्ड एरिया को दिखाएगा।

*चेकबॉक्स* पर क्लिक करके फाइल को **स्टेज** करें। फिर एक कमिट मैसेज दर्ज करें।

*नोट: आप स्टेज्ड और अनस्टेज्ड दोनों एरिया से फाइल्स (और हंक्स) चुन सकते हैं और स्पेस बार का उपयोग करके उन्हें संबंधित एरिया में एड/रिमूव कर सकते हैं।*

एक बार जब आप अपने बदलावों को स्टेज कर लेते हैं और कमिट मैसेज जोड़ देते हैं, तो आप फाइनल कमिट करने के लिए "कमिट" बटन दबा सकते हैं।

बधाई हो, आपने अपने फोर्क किए गए रिपॉजिटरी के अपनी ब्रांच के लोकल कॉपी में सभी बदलावों को कमिट कर दिया है। चलिए आगे बढ़ते हैं!

## GitHub पर बदलाव पुश करें

अब आप अपने बदलावों को GitHub पर पुश करने के लिए तैयार हैं। यह आपके फोर्क किए गए प्रोजेक्ट कॉपी में बदलाव भेजेगा।

रिपॉजिटरी -> पुश पर जाएं
या ऊपर दाईं ओर छोटे अप ऐरो पर क्लिक करें।

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/sm-login.png" alt="login" />

अपने Github अकाउंट में यूजरनेम और पासवर्ड से लॉगिन करें।

अगर आप चाहते हैं कि बदलाव सीधे मास्टर ब्रांच पर दिखें तो origin ब्रांच में बदलाव पुश करें, अन्यथा उस ब्रांच को चुनें जिसमें आप पुश करना चाहते हैं।

## समीक्षा के लिए अपने बदलाव सबमिट करें

अगर आप GitHub पर अपनी रिपॉजिटरी पर जाएंगे, तो आपको `तुलना करें और पुल रिक्वेस्ट करें` बटन दिखेगा। इस बटन पर क्लिक करें।

<img style="float: right;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/sublime-merge-tutorial/compare-and-pull.png" alt="create a pull request" />

अब पुल रिक्वेस्ट सबमिट करें।

`पुल रिक्वेस्ट सबमिट करें` बटन पर क्लिक करें।

जल्द ही मैं इस प्रोजेक्ट की मास्टर ब्रांच में आपके सभी बदलावों को मर्ज कर दूंगा। एक बार बदलाव मर्ज हो जाने पर आपको एक ईमेल नोटिफिकेशन मिलेगा।

## आगे क्या करें?

बधाई हो! आपने अभी-अभी स्टैंडर्ड _फोर्क -> क्लोन -> एडिट -> PR_ वर्कफ्लो पूरा किया है जो आपको अक्सर योगदानकर्ता के रूप में देखने को मिलेगा!

अपने योगदान का जश्न मनाएं और इसे अपने दोस्तों और फॉलोअर्स के साथ [वेब ऐप](https://firstcontributions.github.io#social-share) पर शेयर करें।

अगर आपको मदद चाहिए या कोई सवाल है तो आप हमारी स्लैक टीम में जॉइन कर सकते हैं। [स्लैक टीम में जॉइन करें](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)।

### [अतिरिक्त सामग्री](../additional-material/git_workflow_senarios/additional-material.md)

## अन्य टूल्स के लिए ट्यूटोरियल
[मुख्य पेज पर वापस जाएं](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
