[![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)

# 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 क्लाइंट|
|---|---|

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

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

## Sublime Merge

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

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

इस पेज के ऊपर दिए गए **Fork** बटन पर क्लिक करके इस रिपॉज़िटरी को फोर्क करें।
<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 में **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" />

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

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

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

जब पथ सही लगे, **“Clone”** पर क्लिक करें।

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

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

यदि रिपॉज़िटरी Sublime Merge में खुली है, तो आप बदलाव देख पाएँगे।
ऊपर सबसे नए सेक्शन **"x unstaged files"** को चुनें।
जिन फ़ाइलों में बदलाव हुआ है उन्हें देखें और तय करें कि क्या स्टेज करना है।
कमिट संदेश दें (उदाहरण: `"Add <your-name> to Contributors list"` — यह स्पष्ट और अच्छा है)।
जब आप बदलावों से संतुष्ट हों, तो फ़ाइल-दर-फ़ाइल स्टेज करें या **"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" />

यदि मन बदल जाए, तो बदलावों को **unstage** कर सकते हैं या पूरी तरह **discard** भी कर सकते हैं।  
**चेतावनी:** Discard का मतलब बदलावों को स्थायी रूप से हटाना है। इसे तभी करें जब आपको वे बदलाव बिल्कुल नहीं चाहिएँ।

**Commit** पर क्लिक करें, अपना यूज़रनेम और ईमेल दर्ज करें और **Update** दबाएँ।

फिर से **Commit** पर क्लिक करें।

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

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

**Repository -> Push** पर जाएँ  
या ऊपर दाएँ कोने में ऊपर की ओर तीर वाले छोटे आइकन पर क्लिक करें।

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

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

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

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

GitHub पर अपनी रिपॉज़िटरी में जाएँ — आपको **`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" />

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

## आगे क्या?

शाबाश! आपने एक योगदानकर्ता के रूप में अक्सर मिलने वाले मानक वर्कफ़्लो — _fork -> clone -> edit -> PR_ — को पूरा कर लिया है!

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

अगर आपको मदद चाहिए या कोई सवाल है, तो हमारे Slack टीम से जुड़ें: [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)
