[](https://github.com/firstcontributions/open-source-badges)
[
](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
[](https://opensource.org/licenses/MIT)
[](https://www.codetriage.com/roshanjossey/first-contributions)
# پہلی شراکت يا کانٹریبیوشن
اس پروجیکٹ کا مقصد ابتدائی افراد کے اپنا پہلى شركت يا کانٹریبیوشن کرنے کے طریقے کو آسان بنانا اور رہنمائی کرنا ہے۔ اگر آپ اپنا پہلا حصہ ڈالنا چاہتے ہیں تو نیچے دیے گئے مراحل پر عمل کریں۔
## اس ریپوزٹری کو فورک کریں
اس صفحے کے سب سے اوپر فورک بٹن دبا کر اس ریپوزٹری کا استعمال کریں.
یہ آپ کے اکاؤنٹ میں اس کی ایک نقل بنا كے ذخیرہ کرے گا۔.
## ریپوزٹری کا کلون کیجیے
اب آپ اپنے کمپیوٹر مشین پر یہ ریپوزٹری کلون کریں.
کلون بٹن کو دبائیں اور پھر "copy to clipboard" آئیکن کو دبائیں۔
ایک ٹرمینل کھولیں اور مندرجہ ذیل گٹ کمانڈ چلائیں:
```bash
git clone "یو آر ایل جو آپ نے ابھی کاپی کیا"
```
جہاں "یو آر ایل جو آپ نے ابھی کاپی کیا" (اقتباس کے نشانات " " کے بغیر) اس ریپوزٹری کو کلون کرنے کا یو آر ایل کا اندراج مراد ہے. یو آر ایل حاصل کرنے کیلئے پچھلے مرحلے کو دیکھیں.
مثال کے طور پر:
```bash
git clone https://github.com/this-is-you/first-contributions.git
```
اس میں 'this-is-you' آپکا GitHub یوزرنیم ہے۔ یہاں آپ first-contributions GitHub ریپوزٹری کے مندرجات کمپیوٹر پر نقل کر رہے ہیں.
## ایک شاخ (برانچ) بنائیں
اپنے کمپیوٹر پر ریپوزٹری کی ڈائرکٹری تبدیل کریں (اگرآپ پہلے سے وہاں نہیں ہیں):
```bash
cd first-contributions
```
اب git checkout کمانڈ استعمال کرتے ہوئے ایک شاخ/برانچ تشکیل دیں :
```bash
git checkout -b
```
مثال کے طور پر:
```bash
git checkout -b add-alonzo-church
```
شاخ (برانچ) کا نام میں ضروری نہیں add شامل کریں، لیکن یہ مناسب ہے کہ اس میں یہ شامل ہو، کیونکہ اس شاخ کا مقصد آپ کے نام کو فہرست میں شامل کرنا ہے.
## ضروری تبدیلیاں کریں اور ان تبدیلیوں کو انجام دیں۔
اب Contributors.md فائل کو ٹیکسٹ ایڈیٹر پر کھولیں، اپنا نام اس میں شامل کریں، اور پھر فائل کو محفوظ کریں۔ نام فائل کے شروع یا آخر میں شامل نہ کریں۔ اسے درمیان میں کہیں بھی ڈال دیں۔اگر آپ پراجیکٹ ڈائرکٹری میں جاتے ہیں اور کمانڈ git status کو چلاتے ہیں، تو آپ دیکھیں گے کہ تبدیلیاں موجود ہیں. ان تبدیلیوں کو اس شاخ میں git add کمانڈ استعمال کرتے ہوئے شامل کریں، جسے ابھی آپ نے بنایا تھا۔ :
```bash
git add Contributors.md
```
اب git commit کمانڈ کا استعمال کرتے ہوئے ان تبدیلیوں کا ارتکاب کریں:
```bash
git commit -m "Add to Contributors list"
```
<your-name> کو اپنے نام کے ساتھ تبدیل کردیں.
## ان تبدیلیوں کو GitHub پردهکیل دیں۔
git push کمانڈ کے ذریعے اپنی تبدیلیوں کو پش کریں:
```bash
git push origin
```
<add-your-name> کو شاخ کے نام کے ساتھ بدل دیں، جسے آپ نے پہلے بنایا تھا.
## اپنی تبدیلیوں کو جائزے کیلئے جمع کروائیں۔
اگر آپ GitHub پر اپنی ریپوزٹری پر جاتے ہیں تو، آپ کو Compare & pull request دکھائی دے گا. اس بٹن کو دبائیں.
اب پل درخواست جمع کروائیں.
جلد ہی میں آپ کی تمام تبدیلیوں کو اس پروجیکٹ کی ماسٹر شاخ میں ضم کر دونگا. تبدیلیوں کو ضم کرنے کے بعد آپ کو نوٹیفکیشن ای میل مل جائے گی
## آگے کیا کرنا چاہیے؟
مبارک ہو! آپ نے کامیابی سے
فورک -> کلون -> ترمیم -> پل ریکویسٹ ورک فلو
مکمل کر لیا ہے جو آپ کو اکثر ایک شراکت دار کے طور پر ملے گا
اپنی شراکت کا جشن منائیں اور اپنے دوستوں اور فالوورز کے ساتھ اسے
ویب ایپ
پر جا کر شیئر کریں۔
اب ہم آپ کو دوسرے پراجيكٹس میں شراکت کرنے کے لئے دعوت ديتے ہیں۔
ادھر آپ چند
مقبول ذخیروں
میں کچھ ابتدائی سطح کے مسائل حل کر سکتے ہیں. آگے بڑھیے اور مزید جاننے کے لئے ان ذخیروں پر جائیے۔
[ اضافی مواد ](../additional-material/git_workflow_scenarios/additional-material.md)
## دوسرے ٹولز کو استعمال کرتے ہوئے سبق۔
| 
| 
| 
| 
| 
| 
|
| --- | --- | --- | --- | --- | --- |
| [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |
اس منصوبے کی حمایت کی ہے
