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

First Contributions — हिंदी

	Sublime Merge Git क्लाइंट

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

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

Sublime Merge

Sublime Merge डाउनलोड करें, इंस्टॉल करें और ओपन करें।

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

इस पेज के ऊपर दिए गए Fork बटन पर क्लिक करके इस रिपॉज़िटरी को फोर्क करें। यह आपकी अकाउंट में इस रिपॉज़िटरी की एक कॉपी बना देगा।

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

Sublime Merge में File -> Clone 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"।

ज़रूरी बदलाव करें और उन्हें कमिट करें

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

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

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

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

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

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

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

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

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

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

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

GitHub पर अपनी रिपॉज़िटरी में जाएँ — आपको Compare & pull request बटन दिखेगा। उस पर क्लिक करें।

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

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

आगे क्या?

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

अपने योगदान का जश्न मनाएँ और अपने दोस्तों व फ़ॉलोअर्स के साथ शेयर करें: web app।

अगर आपको मदद चाहिए या कोई सवाल है, तो हमारे Slack टीम से जुड़ें: Join slack team।

अतिरिक्त सामग्री

अन्य टूल्स के साथ ट्यूटोरियल्स

मुख्य पृष्ठ पर वापस जाएँ