Merge branch 'main' into add-hindi-sublime-merge

2026-05-13 17:21:50 +00:00 · 2025-10-05 13:34:56 +02:00
parent 302b0124c6 c8bff1a589
commit 25e15e3a0b
109 changed files with 5509 additions and 2488 deletions
@@ -0,0 +1,119 @@
+[![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/Readme/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)
+
+# Erste Beiträge
+
+| <img alt="Visual Studio Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width="40"> | Visual Studio Code |
+| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ |
+
+
+Es ist schwer. Es ist immer schwer, wenn man etwas zum ersten Mal macht. Vor allem, wenn man mit anderen zusammenarbeitet, ist es nicht angenehm, Fehler zu machen. Aber bei Open Source geht es gerade um Zusammenarbeit und gemeinsames Arbeiten. Wir wollten neuen Open-Source-Mitwirkenden den Einstieg erleichtern, damit sie lernen und zum ersten Mal einen Beitrag leisten können.
+
+Das Lesen von Artikeln und das Anschauen von Tutorials kann hilfreich sein, aber nichts ist besser, als die Dinge einfach auszuprobieren, ohne etwas zu vermasseln. Dieses Projekt zielt darauf ab, Anfängern eine Anleitung zu bieten und ihnen den Weg zu ihrem ersten Beitrag zu erleichtern. Denke daran: Je entspannter Du bist, desto besser lernst Du. Wenn Du Deinen ersten Beitrag leisten möchtest, folge einfach den folgenden einfachen Schritten. Wir versprechen Dir, es wird Spaß machen.
+
+Wenn du Visual Studio Code nicht auf deinem Computer installiert hast, [installiere es jetzt.](https://code.visualstudio.com/download).
+
+**Anmerkung:** Dieses Tutorial wurde mit Visual Studio Code (Version 1.27.2) auf einem Windows 10-Rechner erstellt. Später in diesem Tutorial werden wir einige Tastaturkürzel verwenden. Diese können sich je nach Betriebssystem (macOS/Linux) und Tastatursprache (UK, DE usw.) unterscheiden. Du kannst Deine Liste der Tastaturkürzel durchsuchen, indem Du in der Befehlspalette nach „shortcut” suchst.
+
+## Dieses Repository forken
+
+<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
+
+Forke dieses Repository, indem Du oben rechts auf dieser Seite auf die Schaltfläche „Fork“ klickst. Dadurch wird eine Kopie dieses Repositorys in Ihrem GitHub-Konto erstellt.
+
+GitHub verfolgt die Beziehung zwischen Ihrem Repository und dem Repository, von dem Sie es geforkt haben. Sie können sich Ihr Repository als Arbeitskopie vorstellen.
+
+Die meisten Top-Level-Repositorys auf GitHub (d. h. solche, die nicht von einem anderen Repository geforkt wurden) haben ein kleines Kernteam von Personen, welche Änderungen direkt committen können. Alle anderen Mitwirkenden müssen das Repo forken und Änderungen im Fork vornehmen, dann einen Pull Request erstellen, um zu beantragen, dass ihre Änderungen wieder in das Top-Level-Repo übernommen werden. Wenn dem Administrator des Top-Level-Repos die Änderungen gefallen, werden sie übernommen und Du wirst sofort berühmt und reich! Mehr dazu später.
+
+## Das Repository klonen
+
+<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
+
+Der nächste Schritt besteht darin, Dein Repository auf Deinen Computer zu klonen, damit Du Änderungen vornehmen kannst. VS Code benötigt die URL Deines Repositories, also klicke auf die Schaltfläche „Code“ und dann auf das Symbol „In die Zwischenablage kopieren“.
+
+**ACHTUNG:** Ein Fehler, den neue Mitwirkende oft machen, ist, dass sie das Repository, von dem sie geforkt haben klonen an Stelle ihres eigenen. Überprüfe die Adressleiste Deines Browsers und stelle sicher, dass Du Dein Repository klonst.
+
+Öffne nun Visual Studio Code. Die Willkommensseite von VS Code wird angezeigt. Drücke `F1`, um die Leiste zu öffnen, die unten gezeigt wird. Beachte, dass bereits ein `>` (größer als) Zeichen im Textfeld steht. Du kannst auch über `CTRL-P` zum Eingabeaufforderung gelangen und das `>`-Zeichen eingeben.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone.png" alt="Clone Popup (Command Popup)" />
+
+Vielleicht bemerkst Du, dass bereits einige obskure Befehle aufgelistet sind. Das sind meine zuletzt verwendeten Befehle. Also kümmere Dich nicht darum.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone1.png" alt="Clone repo" />
+
+Nun tippe `git clone`, nur `git` oder `clone` (es funktioniert wie eine Suche).
+Wähle den Eintrag `Git: Clone` aus und drücke `Enter`.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone2.png" alt="Paste Repository URL in" />
+
+Füge die URL Deines Repositories ein und drücke `Enter`. Dadurch wird der Datei-Explorer geöffnet, in dem Du auswählen kannst, wo das Git-Repository gespeichert werden soll.
+
+**Wichtig**: Achte darauf, dass es sich um das geforkte Repository handelt und nicht um das Original, da es sonst nicht funktioniert.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone3.png" alt="Status popup" />
+
+Du solltest eine Statusmeldung in der unteren rechten Ecke von Visual Studio Code sehen. Nachdem der Vorgang abgeschlossen ist, kannst Du das geklonte Repository (jetzt ein Ordner auf Deinem Computer) mit den Schaltflächen im Dialogfeld öffnen.
+
+## Erstelle einen Branch
+
+Öffne die Befehls-Palette erneut, indem Du `F1` drückst. Tippe `branch` ein und wähle den Befehl `create branch` aus. Im nächsten Schritt gib den Namen Deines neuen Branches ein, zum Beispiel `add-david-kroell`. Drücke `Enter`, um den Branch zu erstellen. Der Branch ist auch bereits ausgecheckt. [Was bedeutet checkout?](https://www.git-scm.com/docs/git-checkout)
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-branch.png" alt="Branches Command Palette" />
+
+## Nötige Änderungen vornehmen
+
+Öffne `Contributors.md` in einem Texteditor und füge Deinen Namen hinzu. Achte darauf, dass Du den Namen nicht am Anfang oder am Ende der Datei hinzufügst. Speichere die Datei anschließend.
+Diese Datei enthält GFM (GitHub Flavored Markdown), eine proprietäre Variante der <a href="https://en.wikipedia.org/wiki/Markdown">Markdown-Syntax</a>.
+
+Kopiere eine der anderen Mitwirkenden-Zeilen und passe sie mit Deinem Namen an, um sicherzustellen, dass die Syntax korrekt ist - sie kann schwierig sein. Speichere die Datei, um die Änderung zu registrieren.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-changes.png" alt="Add your name" />
+
+## Änderungen committen und zu GitHub pushen
+
+Auf der linken Seite von VS Code befindet sich ein Menü mit 5 Symbolen. Wähle das Versionskontroll-/Quellcodeverwaltungssymbol aus.
+(Shortcut: `Ctrl + Shift + G`)
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-commit.png" alt="Commit changes" />
+
+Der Datei-Explorer zeigt alle Dateien an, die seit dem letzten Commit geändert wurden. Wenn Du mit der Maus über die Dateien fährst und auf das `+` (Plus) klickst, werden die Dateien zum Staging hinzugefügt.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-commit1.png" alt="Stashed Files">
+
+Tippe etwas in die Zeile oben im Explorer und drücke das Häkchen. Die Änderungen sind jetzt in Deiner lokalen Kopie committed. Jetzt müssen die Änderungen zurück zu GitHub gepusht werden.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-push.png" alt="Stashed Files">
+
+Klicke auf das Drei-Punkte-Symbol, um das Menü zu öffnen, in dem Du die Option `Publish Branch` auswählst. Dadurch sollte ein Dialogfeld geöffnet werden, in dem Du Deine GitHub-Anmeldeinformationen eingeben kannst.
+
+<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-gh-auth.png" alt="Stashed Files">
+
+## Änderungen zur Überprüfung absenden
+
+An diesem Punkt hast Du Deine Änderung abgeschlossen, aber sie befindet sich noch nur in Deinem Repository. Dieser Schritt zeigt Dir, wie Du eine Anfrage an den Administrator des Top-Level-Repos stellen kannst, um Deine Änderung zusammenzuführen.
+
+In Deinem Repository auf GitHub siehst Du neben der Benachrichtigung über den neuen Branch die Schaltfläche `Compare & pull request`. Klicke auf diese Schaltfläche.
+
+<img src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
+
+Sende jetzt den Pull Request ab.
+
+<img src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
+
+Ich werde nun Deine Änderungen in den Master-Branch dieses Projekts mergen. Du erhältst eine E-Mail, sobald dies geschehen ist.
+
+## Und jetzt?
+
+Herzlichen Glückwunsch! Du hast gerade den Standard-Workflow _fork -> clone -> edit -> PR_ abgeschlossen, den Du als Contributor häufig antreffen wirst!
+
+Feiere Deinen Beitrag zum Projekt und teile ihn mit Deinen Freunden und Followern über unsere [Web-App](https://firstcontributions.github.io#social-share).
+
+Du kannst dem Slack-Team beitreten, falls Du Hilfe benötigst oder Fragen hast. [Slack-Team beitreten](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
+
+
+### [Weiterführende Materialien](../additional-material/git_workflow_scenarios/additional-material.md)
+
+## Tutorials mit anderen Tools
+[Zurück zur Hauptseite](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
@@ -0,0 +1,117 @@
+[![ओपन सोर्स को प्यार](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)
@@ -0,0 +1,95 @@
+ٹھیک ہے 👍 آپ نے جو متن دیا ہے وہ **First Contributions** گائیڈ ہے (GitKraken ایڈیٹر کے ساتھ)۔ میں اس کو اُردو میں ترجمہ کر رہا ہوں تاکہ آسانی سے سمجھ سکیں۔
+
+---
+
+# پہلی شراکتیں (First Contributions)
+
+| <img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="200"> | GitKraken ایڈیشن |
+| ------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
+
+یہ مشکل ہے۔ پہلی بار کچھ کرنے پر ہمیشہ مشکل لگتا ہے۔ خاص طور پر جب آپ تعاون (collaboration) کر رہے ہوں تو غلطیاں کرنا اچھا نہیں لگتا۔ لیکن اوپن سورس کا مقصد ہی تعاون اور ایک ساتھ کام کرنا ہے۔ ہم چاہتے تھے کہ نئے لوگ آسانی سے سیکھ سکیں اور اپنی پہلی شراکت (contribution) کر سکیں۔
+
+آرٹیکل پڑھنا اور ویڈیوز دیکھنا مددگار ہوتا ہے، لیکن اصل مزہ تب ہے جب آپ خود کر کے سیکھیں بغیر کچھ توڑے پھوڑے۔ اس پروجیکٹ کا مقصد یہ ہے کہ نئے لوگ آسانی سے اپنی پہلی شراکت کریں۔ یاد رکھیں جتنا ریلیکس رہیں گے، اتنا بہتر سیکھیں گے۔ اگر آپ پہلی بار کانٹریبیوٹ کرنا چاہتے ہیں تو نیچے دیے گئے آسان مراحل پر عمل کریں۔ یقین کریں یہ مزےدار ہوگا۔
+
+---
+
+## GitKraken
+
+[GitKraken](https://www.gitkraken.com) ڈاؤن لوڈ کریں، انسٹال کریں اور کھولیں۔
+
+آپ کو "Welcome to GitKraken" کا ڈائیلاگ باکس نظر آئے گا۔ GitHub کے ساتھ لاگ ان کریں اور GitKraken کو اپنے GitHub اکاؤنٹ تک رسائی دیں۔
+
+(اختیاری) File -> Preferences میں جا کر اپنے پروجیکٹ کا ڈائریکٹری سیٹ کریں تاکہ وہ آپ کے مقامی ریپوزیٹریز کے ساتھ جڑ جائے۔
+
+---
+
+## ریپوزیٹری کو فورک کریں
+
+اس صفحے کے اوپر دائیں طرف موجود **Fork** بٹن پر کلک کریں۔
+
+یہ آپ کے اکاؤنٹ میں اس ریپوزیٹری کی ایک کاپی بنا دے گا۔
+
+---
+
+## ریپوزیٹری کو کلون کریں
+
+GitKraken میں جائیں: File -> Clone Repo.
+
+GitHub.com منتخب کریں۔ اپنے یوزرنیم کے نیچے **first-contributions** ریپوزیٹری دکھائی دے گی۔ اسے منتخب کریں اور آخر میں دی گئی لوکل پاتھ چیک کر لیں۔
+
+جب سب صحیح لگے تو "Clone the repo!" پر کلک کریں۔
+
+---
+
+## نئی برانچ بنائیں
+
+ٹول بار میں *branch* بٹن پر کلک کریں۔
+
+برانچ کا نام رکھیں: "add-your-name"
+مثال: `"add-william-sutton"`
+
+---
+
+## تبدیلیاں کریں اور Commit کریں
+
+`Contributors.md` فائل کو کھولیں اور اپنا نام شامل کریں۔ فائل محفوظ (save) کریں۔
+
+اب GitKraken میں تبدیلیاں نظر آئیں گی۔ اپنی تبدیلیوں کو stage کریں اور ایک اچھا commit میسج لکھیں۔
+مثال: `"Add <your-name> to Contributors list"`
+
+پھر **commit** بٹن پر کلک کریں۔
+
+مبارک ہو 🎉 آپ نے اپنی تبدیلیاں مقامی ریپوزیٹری میں محفوظ کر لی ہیں۔
+
+---
+
+## تبدیلیاں GitHub پر Push کریں
+
+ٹول بار میں *Push* بٹن پر کلک کریں۔
+
+اپنی برانچ کو GitHub پر بھیج دیں تاکہ آپ کی تبدیلیاں وہاں بھی نظر آئیں۔
+
+---
+
+## Pull Request بھیجیں
+
+GitHub پر جائیں، آپ کو "Compare & pull request" کا بٹن نظر آئے گا۔ اس پر کلک کریں۔
+
+اب اپنی pull request سبمٹ کریں۔
+
+آپ کی تبدیلیاں ریویو کے بعد مین برانچ میں شامل کر دی جائیں گی۔ جب ایسا ہوگا آپ کو ای میل نوٹیفکیشن ملے گا۔
+
+---
+
+## اگلے مراحل
+
+مبارک ہو! آپ نے وہ مکمل ورک فلو کر لیا جو ایک عام اوپن سورس کانٹریبیوٹر کو کرنا پڑتا ہے:
+**fork → clone → edit → PR**
+
+اپنی شراکت کا جشن منائیں 🎉 اور اسے دوستوں کے ساتھ شیئر کریں۔
+
+اگر مزید مدد چاہیے تو آپ [Slack ٹیم](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) میں بھی شامل ہو سکتے ہیں۔
+
+---
+
+کیا آپ چاہتے ہیں میں اس کا **سارانس (short version)** بھی اردو میں بنا دوں تاکہ پہلی بار اوپن سورس کنٹریبیوٹ کرنے والے کو صرف بنیادی مراحل نظر آئیں؟