first-contributions/docs/gui-tool-tutorials/sublime-merge-tutorial.hi.md

[![Open Source Love](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)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/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 Client)|
|---|---|

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

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


## सब्लाइम मर्ज (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" />

सब्लाइम मर्ज में जाएं, File -> Clone Repository चुनें।


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

अगला कदम है अपने रिपॉजिटरी को अपनी मशीन पर क्लोन करना ताकि आप बदलाव करना शुरू कर सकें। सब्लाइम मर्ज को आपके रिपॉजिटरी का URL चाहिए, तो "clone" बटन दबाएं और फिर "copy to clipboard" आइकन पर क्लिक करें।

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

सब्लाइम मर्ज में रिपॉजिटरी का URL डालें, रिपॉजिटरी का नाम दें (या खाली छोड़ दें) और वह डायरेक्टरी चुनें जहाँ आप इसे सेव करना चाहते हैं।

रास्ते से संतुष्ट होने पर "Clone" पर क्लिक करें।

## एक शाखा बनाएं

Branches पर राइट-क्लिक करें -> Create Branch  
या  
Repository -> Create Branch पर जाएं।

अपनी शाखा का नाम रखें "add-your-name", जैसे: "add-william-sutton"

<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` फ़ाइल किसी टेक्स्ट एडिटर में खोलें और अपना नाम इसमें जोड़ें, फिर फ़ाइल को सेव करें।

अगर आपकी रिपॉजिटरी सब्लाइम मर्ज में खुली है तो आपको बदलाव दिखाई देंगे।  
सबसे ऊपर नया कमिट चुनें, जिसका नाम "x unstaged files" होगा।  
बदले गए फ़ाइलों की समीक्षा करें और तय करें कि कौन से बदलाव को स्टेज करना है।  
कमिट संदेश दें ("Add <your-name> to Contributors list" अच्छा और स्पष्ट लगता है)।  
जब आप अपने बदलावों से संतुष्ट हों तो उन फ़ाइलों को स्टेज करें। आप एक-एक फाइल को स्टेज कर सकते हैं या "stage all" चुन सकते हैं। स्टेजिंग गिट को बताने के लिए ज़रूरी है कि किस फाइल के बदलाव कमिट में शामिल होने हैं।

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

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

कमिट करें, अपना यूजरनेम और ईमेल डालें और अपडेट पर क्लिक करें।  
फिर से कमिट करें।

बधाई हो, आपने अपने लोकल कॉपी पर सारे बदलाव कमिट कर दिए हैं।

## गिटहब पर बदलाव पुश करें

Repository -> Push पर जाएं  
या ऊपर दाईं तरफ की छोटी तीर पर क्लिक करें।

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

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

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

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

गिटहब पे अपनी रिपॉजिटरी पर जाएं, आपको 'Compare & pull request' बटन दिखेगा। उस पर क्लिक करें।

<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" />

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

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

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

## अब आगे कहाँ जाएं?

बधाई हो! आपने standard _fork -> clone -> edit -> PR_ वर्कफ़्लो पूरा कर लिया है, जिसे आप अक्सर योगदान के दौरान देखेंगे!

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

अगर आपको मदद चाहिए या कोई सवाल है तो आप हमारे स्लैक टीम में शामिल हो सकते हैं। [Join slack team](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)