# [اس پروجیکٹ میں حصہ لیں](https://syknapse.github.io/Contribute-To-This-Project/)

![تصویر کی معلومات](/favicon.png)
 
> لوگو 💖 کے ساتھ بنایا گیا ہے [CandidDeer](https://github.com/CandidDeer) کے ذریعے

[![ٹویٹ کریں](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?url=https%3A%2F%2Fsyknapse.github.io%2FContribute-To-This-Project%2F)

[![ڈسکارڈ](https://badgen.net/discord/online-members/tWkvS4ueVF?label=Join%20Our%20Discord%20Server&icon=discord)](https://discord.gg/tWkvS4ueVF 'ہمارے ڈسکارڈ سرور میں شامل ہوں!')
[![PRs کا خیر مقدم ہے](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://syknapse.github.io/Contribute-To-This-Project/)
[![اوپن سورس محبت](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://syknapse.github.io/Contribute-To-This-Project/)

---

> ## **اعلان:**
>
> کیا آپ اس پروجیکٹ کے منتظم بننا چاہتے ہیں اور اسے جاری رکھنے میں مدد کرنا چاہتے ہیں؟ اگر آپ دلچسپی رکھتے ہیں، تو براہ کرم [منتظمین کے لئے گائیڈ](/maintainer_guide.md) پڑھیں، [ڈسکارڈ سرور](https://discord.gg/tWkvS4ueVF) میں شامل ہوں، اور پروجیکٹ کے منتظمین سے ٹیم میں شامل ہونے کی درخواست کریں۔

---

### فوری رسائی کا فہرست

- [تعارف](#تعارف)
- [مقاصد](#مقاصد)
- [کس کے لئے؟](#کس-کے-لئے)
- [مجھے یہ کیوں کرنا چاہیے؟](#مجھے-یہ-کیوں-کرنا-چاہیے)
- [میں کیا حصہ ڈالوں گا؟](#میں-کیا-حصہ-ڈالوں-گا)
- [ترجمے](#ترجمے)
- [سیٹ اپ! :)](#سیٹ-اپ)
- [حصہ ڈالیں](#حصہ-ڈالیں)
  - [مرحلہ 1: اس ریپوزیٹری کو فورک کریں](#مرحلہ-1-اس-ریپوزیٹری-کو-فورک-کریں)
  - [مرحلہ 2: ریپوزیٹری کو کلون کریں](#مرحلہ-2-ریپوزیٹری-کو-کلون-کریں)
  - [مرحلہ 3: ایک نئی برانچ بنائیں](#مرحلہ-3-ایک-نئی-برانچ-بنائیں)
  - [مرحلہ 4: index.html فائل کھولیں](#مرحلہ-4-indexhtml-فائل-کھولیں)
  - [مرحلہ 5: کارڈ ٹیمپلیٹ کاپی کریں](#مرحلہ-5-کارڈ-ٹیمپلیٹ-کاپی-کریں)
  - [مرحلہ 6: اپنی تبدیلیاں لاگو کریں](#مرحلہ-6-اپنی-تبدیلیاں-لاگو-کریں)
  - [مرحلہ 7: اپنی تبدیلیاں محفوظ کریں](#مرحلہ-7-اپنی-تبدیلیاں-محفوظ-کریں)
  - [مرحلہ 8: GitHub پر اپنی تبدیلیاں دھکیلیں](#مرحلہ-8-github-پر-اپنی-تبدیلیاں-دھکیلیں)
  - [مرحلہ 9: پل ریکویسٹ بھیجیں](#مرحلہ-9-پل-ریکویسٹ-بھیجیں)
  - [مرحلہ 10: جشن منائیں](#مرحلہ-10-جشن-منائیں)
- [اگلے مراحل](#اگلے-مراحل)
- [شکریہ اور تعظیم](#شکریہ-اور-تعظیم)
- [لائسنس](#لائسنس)
- [سرفہرست 100 شراکت دار](#سرفہرست-100-شراکت-دار)

---

## تعارف

یہ ایک گائیڈ ہے جو پہلی بار شراکت داروں کو ایک سادہ اور آسان پروجیکٹ میں حصہ لینے میں مدد دیتا ہے۔

### مقاصد

- ایک اوپن سورس پروجیکٹ میں حصہ ڈالنا۔
- GitHub کے استعمال میں مزید آرام محسوس کرنا۔

### کس کے لئے؟

- یہ بالکل ابتدائی افراد کے لئے ہے۔ اگر آپ `<a href="" target=""></a>` ٹیگ میں لنک لکھنا اور تدوین کرنا جانتے ہیں تو آپ کو اس کام کو کرنے کے قابل ہونا چاہیے۔
- یہ ان لوگوں کے لئے بھی ہے جنہوں نے پہلے کبھی کوئی اوپن سورس میں حصہ نہیں لیا ہے، یا وہ جنہیں مزید شراکتیں کرنے کی ضرورت ہے تاکہ تجربہ اور خوداعتمادی میں اضافہ ہو۔

### مجھے یہ کیوں کرنا چاہیے؟

کسی بھی ویب ڈویلپر، چاہے وہ طموح ہو یا تجربہ کار، کو ورژن کنٹرول کے لئے Git کا استعمال کرنا ضروری ہے، اور GitHub وہ مقبول ترین ہوسٹنگ سروس ہے جسے سب استعمال کرتے ہیں۔ یہ اوپن سورس کمیونٹی کا دل ہے۔ GitHub کو استعمال کرنے میں مہارت حاصل کرنا ایک بنیادی ہنر ہے۔ کسی پروجیکٹ میں حصہ ڈالنے سے آپ کی خوداعتمادی بڑھے گی اور آپ کے GitHub پروفائل میں کچھ دکھانے کے لئے بھی ہوگا۔

اگر آپ نئے ویب ڈویلپر ہیں اور سوچ رہے ہیں کہ کیا آپ کو Git اور GitHub سیکھنے کی ضرورت ہے، تو اس کا جواب یہ ہے: [آپ کو Git کل سیکھنا چاہیے تھا](https://codeburst.io/number-one-piece-of-advice-for-new-developers-ddd08abc8bfa 'نئے ڈویلپر؟ آپ کو Git کل سیکھنا چاہیے تھا۔ برینڈن مورلی، CodeBurst.io کے بانی')۔

### میں کیا حصہ ڈالوں گا؟

![شراکت کارڈ](/readme-only/card.PNG 'شراکت کارڈ')

آپ اس [پروجیکٹ ویب صفحہ](https://syknapse.github.io/Contribute-To-This-Project/ 'https://syknapse.github.io/Contribute-To-This-Project') پر اس قسم کا کارڈ شامل کریں گے۔ یہ آپ کے نام، ٹویٹر آئی ڈی، مختصر تفصیل، اور 3 ویب ڈویلپرز کے لئے مفید وسائل کے لنکس پر مشتمل ہوگا جن کی آپ سفارش کرتے ہیں۔

آپ HTML فائل میں کارڈ ٹیمپلیٹ کو کاپی کریں گے اور اسے اپنی معلومات کے مطابق تخصیص کریں گے۔

---

### ترجمے

یہ گائیڈ دیگر [زبانوں میں بھی دستیاب](#ترجمے) ہے۔

| [عربی](/translations/README/ARABIC.md) | [بنگالی](/translations/README/BANGLA.md) | [روایتی چینی](/translations/README/CHINESE_TRADITIONAL.md) | [ڈچ](/translations/README/DUTCH.md) | [انگریزی](/README.md) |
| :-------------------------------------: | :---------------------------------------: | :-------------------------------------------------------: | :---------------------------------: | :-------------------: |
| [فرانسیسی](/translations/README/FRENCH.md) | [جرمن](/translations/README/GERMAN.md) | [ہندی](/translations/README/HINDI.md) | [اطالوی](/translations/README/ITALIAN.md) | [جاپانی](/translations/README/JAPANESE.md) |
| [کورین](/translations/README/KOREAN.md) | [پولش](/translations/README/POLISH.md) | [پرتگالی](/translations/README/PORTUGUESE.md) | [روسی](/translations/README/RUSSIAN.md) | [سربین](/translations/README/SERBIAN.md) |
| [ہسپانوی](/translations/README/SPANISH.md) | [ترکی](/translations/README/TURKISH.md) | [یوکرینی](/translations/README/UKRAINIAN.md) | [ناروے](/translations/README/NORWEGIAN.md) |

> پروجیکٹس میں دستاویزات کے ترجمے کا خیر مقدم کیا جاتا ہے۔ حصہ لینے کے لئے [`ترجمہ گائیڈ`](/translations/README.md) پڑھیں۔

---
### سیٹ اپ! :)

> [!نوٹ]
> یہ ٹیوٹوریل GitHub پی سی پر مبنی ہے۔ [اگر آپ ٹرمینل سے کام کرنے میں آرام دہ ہیں، تو اس ٹیوٹوریل پر جائیں (یہاں کلک کریں)](/terminal_tutorial.md)

سب سے پہلے، آئیے کام کرنے کے لیے سیٹ اپ کرتے ہیں

1. اپنے GitHub اکاؤنٹ میں لاگ ان کریں۔ اگر ابھی تک آپ کا اکاؤنٹ نہیں ہے تو [GitHub جوائن کریں](https://github.com/join)۔ میں تجویز کرتا ہوں کہ آپ جاری رکھنے سے پہلے [GitHub Hello World ٹیوٹوریل](https://guides.github.com/activities/hello-world/) کریں۔
2. [GitHub Desktop ایپ](https://desktop.github.com/) ڈاؤنلوڈ کریں۔
   - متبادل طور پر، اگر آپ کمانڈ لائن پر Git استعمال کرنے میں آرام دہ ہیں تو آپ یہ کر سکتے ہیں [یہاں CLI ٹیوٹوریل کا لنک ہے](/terminal_tutorial.md)۔
   - اگر آپ [VS کوڈ](https://code.visualstudio.com/ 'Visual Studio Code website') استعمال کرتے ہیں، تو اس میں Git انٹیگریٹڈ ہے اور آپ کو وہ سب کرنے کی اجازت دیتا ہے جو ہمیں ایڈیٹر سے ہی کرنے کی ضرورت ہے۔
   - تاہم، اس ٹیوٹوریل کو فالو کرنے کا سب سے سادہ اور آسان طریقہ GitHub Desktop کا استعمال ہے۔

> اب جب کہ آپ سیٹ اپ ہو چکے ہیں، آئیے پروجیکٹ میں تعاون کے کاروبار پر چلتے ہیں۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
### تعاون کریں

10 آسان مراحل میں ایک اوپن سورس معاون بنیں۔

_اندازاً وقت: 30 منٹ سے کم_۔

#### مرحلہ 1: اس ریپوزٹری کو فورک کریں

- یہاں مقصد اس پروجیکٹ کی ایک کاپی بنانا اور اسے اپنے اکاؤنٹ میں رکھنا ہے۔
- ایک ریپوزٹری (ریپو) GitHub پر پروجیکٹ کو کہا جاتا ہے، اور ایک فورک اس کی کاپی ہوتی ہے۔
- یقینی بنائیں کہ آپ اس ریپو کے [مرکزی صفحہ](https://github.com/Syknapse/Contribute-To-This-Project 'https://github.com/Syknapse/Contribute-To-This-Project') پر موجود ہیں۔

| ![Fork](/readme-only/fork.png "فورک پر کلک کریں") |
| :---------------------------------------------: |
|       **_فورک_ بٹن پر کلک کریں**                |

- اب آپ کے پاس اس پروجیکٹ کی مکمل کاپی آپ کے اپنے اکاؤنٹ میں موجود ہے۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 2: ریپوزٹری کو کلون کریں

- اب ہم پروجیکٹ کی ایک لوکل کاپی بنانا چاہتے ہیں، یعنی آپ کے اپنے کمپیوٹر پر محفوظ کی ہوئی کاپی۔
- GitHub ڈیسک ٹاپ ایپ کھولیں۔ ایپ میں:

| ![کلون](/readme-only/clone.PNG 'کلون ریپوزٹری پر کلک کریں') |
| :-------------------------------------------------------: |
|     **_File_ پر کلک کریں، پھر _Clone repository_ پر**      |

- آپ کو GitHub پر اپنے پروجیکٹس اور فورکس کی فہرست نظر آئے گی۔
- `<your-github-username>/Contribute-To-This-Project` منتخب کریں۔
- _Clone_ پر کلک کریں۔

| ![پروجیکٹ کلون کریں](/readme-only/clone-project.PNG 'پر کلک کریں =your-github-username=/Contribute-To-This-Project') |
| :------------------------------------------------------------------------------------------------------------------: |

| :arrow_right_hook: ایک فورک شدہ پروجیکٹ میں بائیں جانب فورک کا نشان ہوگا۔ آپ کا فورک آپ کے اپنے GitHub یوزر کے ساتھ ہوگا۔ | ![آپ کا فورک](/readme-only/clone-your-fork.PNG 'آپ کا فورک کچھ اس طرح نظر آئے گا، آپ کے یوزر نام کے ساتھ') |
| :--------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------: |

- اس میں کچھ وقت لگے گا جب پروجیکٹ آپ کی ہارڈ ڈسک پر کاپی ہو رہا ہوگا۔ میں تجویز کرتا ہوں کہ آپ ڈیفالٹ راستہ استعمال کریں، جو عموماً `..\Documents\GitHub` ہوتا ہے۔
- اب آپ کے پاس پروجیکٹ کی ایک لوکل کاپی موجود ہے۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 3: ایک نئی برانچ بنائیں

- جب ریپوزٹری کلون ہو جائے اور آپ کے پاس GitHub ڈیسک ٹاپ میں کھلی ہو، تو ایک نئی برانچ بنانے کا وقت ہے۔
- برانچ ایک ایسا طریقہ ہے جس کے ذریعے آپ اپنی تبدیلیوں کو پروجیکٹ کے مرکزی حصے جسے `Master` کہا جاتا ہے، سے الگ رکھ سکتے ہیں۔ مثلاً، اگر کچھ غلط ہو جائے یا آپ اپنی تبدیلیوں سے خوش نہ ہوں، تو آپ برانچ کو حذف کر سکتے ہیں اور مرکزی پروجیکٹ متاثر نہیں ہوگا۔

| :arrow_right_hook: _`Current branch`_ پر کلک کریں، پھر _`New`_ پر کلک کریں | ![برانچ بنائیں](/readme-only/branch-new.PNG "برانچ پر کلک کریں، پھر 'New'") |
| :------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------: |
| :arrow_right_hook: **اپنی برانچ کا نام دیں، پھر `Create branch` پر کلک کریں** |                  ![برانچ کا نام دیں](/readme-only/branch-name.PNG 'اپنی برانچ کا نام رکھیں')                   |
| :arrow_right_hook: **اپنی نئی برانچ کو GitHub پر پبلش کریں**                    | ![برانچ پبلش کریں](/readme-only/branch-publish.PNG 'نئی برانچ کو اپنے ریموٹ ریپوزٹری پر GitHub پر بھیجنے کے لیے پبلش پر کلک کریں') |

- آپ اسے جو چاہیں نام دے سکتے ہیں، لیکن چونکہ یہ برانچ اس پروجیکٹ میں آپ کا نام کارڈ شامل کرنے کے لیے ہے، تو اسے `your-name-card` کہنا اچھی عادت ہے کیونکہ اس سے اس برانچ کی نیت واضح رہتی ہے۔
- اب آپ نے ماسٹر سے الگ ایک نئی برانچ بنالی ہے۔
- اگلے مراحل میں، اس بات کو یقینی بنائیں کہ آپ اس برانچ میں کام کر رہے ہیں۔ آپ جس برانچ میں ہیں اس کا نام GitHub ڈیسک ٹاپ ایپ کے اوپر سینٹر میں _Current branch_ کے تحت دکھائی دے گا۔

**`master` برانچ میں کام مت کریں**

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 4: `index.html` فائل کھولیں

- اب ہمیں وہ فائل کھولنی ہے جس میں ہم ترمیم کریں گے، اپنے پسندیدہ کوڈ ایڈیٹر سے۔
- اپنے کمپیوٹر پر پروجیکٹ فولڈر تلاش کریں۔ اگر آپ نے ڈیفالٹ رکھا ہے، تو یہ کچھ ایسا ہوگا: `your-computer > Documents > GitHub > Contribute-To-This-Project`
- `index.html` فائل براہ راست `Contribute-To-This-Project` فولڈر میں موجود ہے۔
- اپنے کوڈ ایڈیٹر (جیسے Sublime, VS Code, Atom وغیرہ) کو کھولیں اور `Open file` کمانڈ استعمال کرتے ہوئے پروجیکٹ کی مرکزی ڈائریکٹری میں `index.html` فائل کو تلاش کریں۔

|                     ![index فائل کھولیں](/readme-only/index-open.PNG 'اپنی ٹیکسٹ ایڈیٹر میں index.html کھولیں')                      |
| :-----------------------------------------------------------------------------------------------------------------------: |
| :arrow_right_hook: **متبادل طور پر آپ اپنی ہارڈ ڈرائیو پر فائل کو تلاش کر سکتے ہیں، دائیں کلک کریں اور اپنے ایڈیٹر کے ساتھ کھولیں** |

- اب آپ کے ایڈیٹر میں وہ فائل کھل چکی ہے جسے آپ نے ایڈٹ کرنا ہے اور آپ اس میں تبدیلیاں کرنے کے لیے تیار ہیں۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 5: کارڈ ٹیمپلیٹ کاپی کریں

- ہم کارڈ ٹیمپلیٹ کی ایک کاپی بنائیں گے تاکہ اس پر کام شروع کیا جا سکے۔
- `<body>` کے بالکل اندر، آپ کو `<div class="container">` سیکشن ملے گا۔ اس میں کئی دوسرے سیکشنز بھی شامل ہیں۔
- **پہلے 2** سیکشنز کچھ اس طرح ہوں گے: `<div class="row">`۔ انہیں اپنے VS Code ایڈیٹر میں ان کے ساتھ موجود تیر پر کلک کرکے collapse کریں، جیسا کہ نیچے دی گئی تصویر میں دکھایا گیا ہے۔ (اگر آپ کوئی دوسرا ایڈیٹر استعمال کر رہے ہیں، تو ہو سکتا ہے کہ آپ اس فیچر کا استعمال نہ کر سکیں، تو آپ کو بس نیچے اسکرول کرنا ہوگا)۔ collapse سے ان کوڈ کمپوننٹس کو چھپانا آسان ہو جاتا ہے جنہیں آپ کو تبدیل کرنے کی ضرورت نہیں ہے۔
- اب آپ کو وہ سیکشن نظر آنا چاہیے جس میں تمام تعاون کارڈز ہیں: `<div class="grid" id="contributions">`

| ![کارڈ ٹیمپلیٹ تلاش کریں](/readme-only/find-card-template.png 'کارڈ ٹیمپلیٹ تلاش کریں') |
| :-------------------------------------------------------------------------: |

- اس سیکشن کے اندر، آپ کو `== TEMPLATE ==` لیبل لگا ہوا سیکشن ملے گا۔
- تصویر میں سرخ باکس کے اندر موجود سب کچھ کاپی کریں، `Contributor card START` کمنٹ سے لے کر `Contributor card END` کمنٹ تک۔

| ![کارڈ ٹیمپلیٹ کاپی کریں](/readme-only/card-copy.PNG 'کارڈ ٹیمپلیٹ کاپی کریں') |
| :-------------------------------------------------------------------------: |

- پورے مواد کو اس کمنٹ کے بالکل نیچے پیسٹ کریں جو اس کی نشاندہی کر رہا ہے؛ بالکل سب سے حالیہ تعاون کرنے والے کے کارڈ کے اوپر۔
- اس بات کو یقینی بنائیں کہ آپ کے کارڈ کے آخر اور آخری کارڈ کے آغاز کے درمیان ایک سطر کا وقفہ ہو۔ اسی طرح، آپ کے کارڈ کے آغاز اور `=== Paste YOUR CARD directly BELOW this line ===` کمنٹ والی سطر کے درمیان ایک سطر کا وقفہ بھی ہو۔ یہ ایک اچھی عادت ہے کہ ہمارا کوڈ جتنا ممکن ہو صاف رہے۔
- کبھی بھی linters یا اسٹائل فارمیٹرز استعمال نہ کریں۔ اس پروجیکٹ میں Prettier سیٹ اپ ہے۔

| ![کارڈ ٹیمپلیٹ پیسٹ کریں](/readme-only/card-paste.PNG 'درج شدہ لائن کے نیچے پیسٹ کریں') |
| :------------------------------------------------------------------------------------: |

- اب یہ **آپ کا** کارڈ ہے، جسے آپ اپنی مرضی سے حسب ضرورت بنا سکتے ہیں اور ایڈٹ کر سکتے ہیں۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 6: اپنی تبدیلیاں لاگو کریں

- اب ہم html میں ترمیم کرنا شروع کریں گے، اپنے کارڈ کے کسٹمائز ایبل فیلڈز میں تبدیلی کرتے ہوئے۔

| :arrow_right_hook: 'Name' کو اپنے نام سے تبدیل کریں | ![نام تبدیل کریں](/readme-only/change-name.PNG 'اپنا نام ٹائپ کریں') |
| :-------------------------------------------------- | :----------------------------------------------------------------: |

- **نوٹ: `class="name"` کو تبدیل نہ کریں۔**

| :arrow_right_hook: اپنے ٹویٹر اکاؤنٹ کے یو آر ایل کو `href="Insert URL here"` میں درج کریں، اور اپنے ہینڈل کو ٹیکسٹ فیلڈ میں ٹائپ کریں۔ | ![رابطہ تبدیل کریں](/readme-only/change-contact.PNG 'اپنے ٹویٹر اکاؤنٹ کا لنک درج کریں اور اپنا ہینڈل ٹائپ کریں') |
| :------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------: |

- اگر آپ ٹویٹر کے علاوہ کوئی دوسرا رابطہ استعمال کرنا چاہتے ہیں تو آپ کو ٹویٹر آئیکن `<i class="fa fa-x-twitter"></i>` کو [Font Awesome Icons](http://fontawesome.io/icons/) پر جاکر صحیح آئیکن تلاش کرکے، اور صرف `fa-x-twitter` حصے کو نئے آئیکن سے تبدیل کرکے، جیسے `fa-facebook`، تبدیل کرنا ہوگا۔ پھر اوپر والے مراحل کو فالو کریں۔

|                                                                                                                                         ![متعلقہ معلومات تبدیل کریں](/readme-only/change-about.PNG 'اپنے بارے میں ایک جملہ لکھیں')                                                                                                                                          |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|                                                                                                             :arrow_right_hook: **ہمارے ساتھ اپنے بارے میں کچھ شیئر کریں۔ مختصر اور جامع رکھیں۔ اس کو ایک ٹویٹ کی طرح سوچیں نہ کہ بلاگ پوسٹ**                                                                                                               |
|                                                                                                           ![وسائل تبدیل کریں](/readme-only/change-resources.PNG 'لنک داخل کریں، ایک مختصر وضاحت لکھیں، اور وسائل کا نام ٹائپ کریں')                                                                                                             |
| :arrow_right_hook: **کمیونٹی کے ساتھ ویب ڈویلپمنٹ کے لیے 3 ایسے وسائل شیئر کریں جو مفید ہوں۔ یہ کچھ بھی ہو سکتا ہے، ویڈیو، بات چیت، پوڈ کاسٹ، مضمون، حوالہ، یا ٹول۔ اگر آپ مبتدی ہیں تو اس سے خوفزدہ نہ ہوں، جو کچھ آپ جانتے ہیں وہی شیئر کریں، چاہے وہ بنیادی ہی کیوں نہ ہو۔ آپ حیران ہوں گے کہ کتنے لوگ اس سے فائدہ اٹھائیں گے۔** |

- **لنک:** یو آر ایل درج کریں `href="یہاں"`، اور `#` کو تبدیل کریں۔ براہ کرم URL شارٹنرز یا ایسے یو آر ایل استعمال نہ کریں جو اس ویب سائٹ سے تعلق نہ رکھتے ہوں جسے آپ پوسٹ کر رہے ہیں!
- **عنوان:** ایک مختصر وضاحت لکھیں `title="یہاں"`۔
- **نام:** وسائل کا نام ٹیکسٹ فیلڈ میں لکھیں `>یہاں</a>`۔
- یقینی بنائیں کہ آپ نے اپنی **تمام تبدیلیاں محفوظ** کر لی ہیں۔
- **اپنی تبدیلیوں کا معائنہ کریں**۔ یہ بہت اہم ہے! html فائل کو اپنے براؤزر میں کھولیں (مثال کے طور پر اس پر ڈبل کلک کرکے) اور دیکھیں کہ آپ کے کارڈ کی ویب سائٹ پرساخت کیسی نظر آتی ہے۔ دیکھیں کہ پوری صفحہ ویسے ہی نظر آ رہا ہے اور کوئی چیز خراب نہیں ہوئی۔ اپنے لنکس پر کلک کریں اور یقینی بنائیں کہ وہ کام کر رہے ہیں۔ کنسول کھولیں (Ctrl + Shift + J (ونڈوز / لینکس) یا Cmd + Opt + J (میک)) اور چیک کریں کہ کوئی ایرر میسجز نہیں ہیں۔
- زبردست! آپ نے اپنا کوڈ ایڈٹ کرنا مکمل کر لیا ہے! اگلے مراحل میں آپ کی تبدیلیاں GitHub پر بھیجی جائیں گی اور پھر انہیں مرکزی پروجیکٹ کے ساتھ ضم کیا جائے گا۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 7: اپنی تبدیلیوں کو کمیٹ کریں

- GitHub ڈیسک ٹاپ ایپ پر واپس جائیں۔
- آپ کی تبدیلیاں خود بخود اسٹیجنگ ایریا میں شامل ہو جائیں گی۔
- اس کا مطلب ہے کہ Git نے تمام **محفوظ شدہ** تبدیلیوں کو ریکارڈ کر لیا ہے۔
- آپ ایپ میں یہ تبدیلیاں دیکھ سکتے ہیں۔ آپ نے فائل میں جو کچھ شامل کیا ہے وہ سبز رنگ میں ہوگا، اور جو کچھ حذف کیا گیا ہے وہ سرخ رنگ میں نظر آئے گا۔

|                                                                                               ![تبدیلیاں کمیٹ کریں](/readme-only/commit.PNG "آپ کی شامل کردہ تبدیلیاں GitHub ڈیسک ٹاپ ایپ کی دائیں جانب سبز رنگ میں نظر آئیں گی۔ کمیٹ بٹن نیچے بائیں جانب ہے۔")                                                                                                |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| :arrow_right_hook: اگلا مرحلہ _`Commit`_ کہلاتا ہے۔ اس کا مطلب ہے `تبدیلیوں کی تصدیق کریں`۔ |
|                                                                                            ![تبدیلیاں کمیٹ کریں](/readme-only/commit-header.PNG "آپ کی شامل کردہ تبدیلیاں GitHub ڈیسک ٹاپ ایپ کی دائیں جانب سبز رنگ میں نظر آئیں گی۔ کمیٹ بٹن نیچے بائیں جانب ہے۔")                                                                                             |
|                                                               :arrow_right_hook: **آپ کا GitHub ڈیسک ٹاپ ہیڈر کچھ اس طرح نظر آنا چاہیے۔ `Current repository` میں پروجیکٹ کے نام کے ساتھ فورک کا نشان نظر آئے گا۔ آپ کی `Current branch` وہی نام رکھے گی جو آپ نے اسے مرحلہ 3 میں دیا تھا۔**                                                                |
|                                                                                              ![کمیٹ میسج لکھیں اور کمیٹ کریں](/readme-only/commit-message.PNG "خلاصہ کے ان پٹ میں مختصر کمیٹ پیغام لکھیں اور 'کمیٹ' پر کلک کریں۔")                                                                                               |
| :arrow_right_hook: **_`Commit`_ کرنے کے لیے آپ کو _`Summary`_ فیلڈ کو بھرنا ہوگا۔ یہ کمیٹ پیغام ہے جس میں آپ وضاحت کریں گے کہ آپ نے کیا تبدیلیاں کی ہیں۔ اس کیس میں `"Add my card information"` ایک مناسب پیغام ہوگا۔ اختیاری طور پر آپ مزید تفصیل _`Description`_ میں دے سکتے ہیں۔ _`Commit`_ بٹن پر کلک کریں۔ آپ کا بٹن کچھ ایسا دکھائے گا `Commit to "your-branch-name"`** |

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 8: اپنی تبدیلیاں GitHub پر پش کریں

- آپ کی تبدیلیاں اب محفوظ یا کمیٹ ہو چکی ہیں، لیکن وہ صرف آپ کے کمپیوٹر پر لوکل طور پر محفوظ ہیں۔
- آپ کی لوکل تبدیلیوں کو GitHub پر موجود ریپوزٹری کے ساتھ ہم آہنگ کرنے کے عمل کو _Push_ کہا جاتا ہے۔ اس میں آپ اپنی تبدیلیوں کو اپنی لوکل ریپوزٹری سے GitHub کی ریموٹ ریپوزٹری پر "پش" کر رہے ہوتے ہیں۔

| :arrow_right_hook: _`Push`_ بٹن پر کلک کریں | ![GitHub پر پش کریں](/readme-only/push.PNG "اپنی تبدیلیاں GitHub پر پش کریں، 'Push' بٹن پر کلک کریں") |
| :------------------------------------------ | :--------------------------------------------------------------------------------------------------: |

- چند سیکنڈز کے بعد یہ عمل مکمل ہو جائے گا اور اب آپ کے پاس اس برانچ کی ایک جیسی کاپی آپ کی مشین پر اور GitHub پر موجود ہو گی۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 9: PR (Pull Request) جمع کروائیں

- یہ وہ لمحہ ہے جس کا آپ انتظار کر رہے تھے؛ _Pull Request_ (PR) جمع کروانے کا وقت۔
- اب تک آپ نے جو بھی کام کیا ہے وہ پروجیکٹ کے فورک پر کیا ہے، جو آپ کو یاد ہوگا کہ آپ کے اپنے GitHub اکاؤنٹ پر موجود ہے۔
- اب وقت آ گیا ہے کہ آپ اپنی تبدیلیاں مرکزی پروجیکٹ میں بھیجیں تاکہ ان کو اس کے ساتھ ضم کیا جا سکے۔
- اسے [_Pull Request_](https://help.github.com/articles/about-pull-requests/ 'About Pull Requests - GitHub Help') کہا جاتا ہے کیونکہ آپ اصل پروجیکٹ کے مینٹینر سے درخواست کر رہے ہیں کہ وہ آپ کی تبدیلیوں کو اپنے پروجیکٹ میں "کھینچ" لیں۔
- GitHub پر **اپنے فورک** کے مرکزی صفحے پر جائیں (اس پر فورک کا آئیکن اور اوپر آپ کا یوزر نیم ہوگا)۔
- ریپوزٹری کے اوپر کی طرف آپ کو ایک ہائیلائٹڈ pull request پیغام نظر آئے گا جس کے ساتھ سبز بٹن ہوگا۔

|  ![Pull Request جمع کروائیں](/readme-only/pull-request.PNG 'یہ عام طور پر صفحہ کے اوپری حصے میں ہوتا ہے، تفصیل کے نیچے اور پروجیکٹ فائلوں اور فولڈرز کے اوپر')  |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|                                                       :arrow_right_hook: **`Compare and pull request` پر کلک کریں**                                                       |
| ![Pull Request کھولیں](/readme-only/pull-request-branches.PNG 'آپ اپنی برانچ کو اپنے فورک سے اصل پروجیکٹ کی ماسٹر برانچ میں ضم کرنے کی درخواست کر رہے ہیں') |
|                                              :arrow_right_hook: یہ وہ صفحہ ہے جو `Open a pull request` صفحے کی طرح نظر آتا ہے۔                                               |

- یاد رکھیں، _آپ اپنی برانچ کو اصل پروجیکٹ کے ساتھ ضم کرنے کی کوشش کر رہے ہیں، نہ کہ اپنے فورک کے `Master` برانچ کے ساتھ_۔
- نیچے دی گئی تصویر آپ کو اندازہ دیتی ہے کہ آپ کے Pull Request کے ہیڈر کو کیسا نظر آنا چاہیے۔
- بائیں جانب اصل پروجیکٹ ہے، اس کے بعد ماسٹر برانچ۔ دائیں جانب آپ کا فورک اور وہ برانچ جسے آپ نے بنایا تھا۔

|                     ![Pull Request جمع کروائیں](/readme-only/pull-request-open.PNG "سبز بٹن پر کلک کریں۔ ڈریں نہیں!")                     |
| :-----------------------------------------------------------------------------------------------------------------------------------------: |
| :arrow_right_hook: **Pull request بنائیں: عنوان لکھیں، تفصیل میں اختیاری معلومات شامل کریں اور `Create pull request` پر کلک کریں** |

- تمام اختیارات سے پریشان نہ ہوں۔ اس وقت آپ کو صرف یہ تین مراحل کرنے کی ضرورت ہے۔
- آپشن `Allow edits from maintainers` کو چیک مارک حالت میں چھوڑ دیں۔
- اب، ایک _Pull Request_ پروجیکٹ کے مینٹینر کو بھیجا جائے گا۔ جیسے ہی اس کا جائزہ لیا جائے گا اور اسے قبول کر لیا جائے گا، آپ کی تبدیلیاں [پروجیکٹ کے ویب صفحے](https://syknapse.github.io/Contribute-To-This-Project 'Contribute To This Project web page') پر نظر آئیں گی۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
#### مرحلہ 10: جشن منائیں

بس، آپ نے کر دکھایا! آپ نے GitHub پر اوپن سورس میں تعاون کیا ہے۔

آپ نے ایک لائیو ویب صفحے پر کوڈ شامل کیا ہے: [https://syknapse.github.io/Contribute-To-This-Project](https://syknapse.github.io/Contribute-To-This-Project)

آپ کی تبدیلیاں **فوری طور پر نظر نہیں آئیں گی**؛ انہیں پہلے پروجیکٹ کے مینٹینر کے ذریعے جائزہ لیا جانا، قبول کیا جانا، اور ضم کیا جانا ہوگا۔ ایک بار ضم ہو جانے کے بعد، آپ کا کارڈ صفحے پر نظر آئے گا اور لائیو ہوگا۔

یہ بہت عام بات ہے کہ کوئی جائزہ لینے والا PR پر تبدیلیاں مانگے۔ اگر ایسا آپ کے ساتھ ہوتا ہے، تو اسے اچھی پریکٹس کے طور پر لیں۔ تبصروں اور درخواست کردہ تبدیلیوں پر نظر رکھیں۔ ایک بار جب آپ درخواست کردہ تبدیلیاں کر لیں (واپس اپنی برانچ میں)، تو آپ کو صرف اپنی تبدیلیوں کو کمیٹ اور پش کرنا ہوگا۔ PR خود بخود نئی تبدیلیوں کے ساتھ اپ ڈیٹ ہو جائے گا۔

میں وعدہ کرتا ہوں کہ میں جائزہ لینے اور ضم کرنے کی کوشش جلد از جلد کروں گا، لیکن میں یہ اپنے فارغ وقت میں کرتا ہوں، اس لیے کچھ دنوں کی تاخیر ناگزیر ہے۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
### اگلے مراحل

- کچھ دیر بعد واپس آئیں تاکہ آپ کی ضم شدہ Pull Request کو چیک کر سکیں۔
- جب آپ کی تبدیلیاں منظور ہو جائیں یا اضافی تبدیلیاں مانگی جائیں، تو آپ کو GitHub سے ایک ای میل موصول ہوگی۔ اور جب PR کو آخرکار ماسٹر کے ساتھ ضم کر دیا جائے اور آپ کا کارڈ شامل ہو جائے۔
- آپ اس _مفت_ سیریز سے بھی سیکھ سکتے ہیں کہ اوپن سورس پروجیکٹ میں کیسے تعاون کیا جائے: [How to Contribute to an Open Source Project on GitHub](https://kcd.im/pull-request)
- اگر آپ کو یہ پروجیکٹ **مفید** لگا ہو تو براہ کرم اسے صفحے کے اوپر :star: اسٹار :star: دیں، اور اس کے بارے میں **ٹویٹ** کریں تاکہ اس کا پیغام پھیلانے میں مدد ہو [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)][twit]
- آپ ہمارے [ڈسکارڈ سرور](https://discord.gg/tWkvS4ueVF) میں بھی شامل ہو سکتے ہیں۔
- آپ **مجھے فالو** کر سکتے ہیں اور [𝕏 (Twitter)](https://twitter.com/Syknapse '@Syknapse') پر رابطہ کر سکتے ہیں، یا [ان دیگر آپشنز کا استعمال کرتے ہوئے](https://syknapse.github.io/Syk-Houdeib/#contact 'My contact section | Portfolio')۔
- یہ ایک اوپن سورس پروجیکٹ ہے، لہذا آپ اپنے کارڈ کے تعاون کے علاوہ بگز کو ٹھیک کرنے، بہتری لانے، یا نئے فیچرز شامل کرنے میں بھی مدد کر سکتے ہیں۔ ایک [ایشو](https://help.github.com/articles/creating-an-issue/ 'Mastering Issues | GitHub Guides') کھولیں یا ایک نیا [پول ریکویسٹ](https://help.github.com/articles/creating-a-pull-request-from-a-fork/ 'Creating a pull request from a fork | GitHub Help') بھیجیں۔
- ہماری کمیونٹی کو بہتر بنانے میں مدد کے لیے، GitHub [Discussions](https://github.com/Syknapse/Contribute-To-This-Project/discussions) ٹیب کو دیکھیں جو Pull Requests کے ساتھ واقع ہے۔ یہ جگہ آپ کو اپنا تعارف کرانے، اوپن سورس پر گہرے مباحثے کرنے، اور پروجیکٹ مینٹینرز کے ساتھ بات چیت کرنے کا موقع دیتی ہے۔ کیا آپ ہمیں اس فیچر کو بنانے اور اپنی کمیونٹی کو بہتر بنانے میں مدد کریں گے؟
- **اس پروجیکٹ میں تعاون کرنے کا شکریہ**۔ اب آپ آگے بڑھ کر دوسرے پروجیکٹس میں بھی تعاون کرنے کی کوشش کر سکتے ہیں؛ `![Good First Issue](https://user-images.githubusercontent.com/29199184/33852733-e23b7070-debb-11e7-907b-4e7a03aad436.png)` لیبل والے آغاز کنندگان کے لیے تعاون کے دوستانہ آپشنز دیکھیں۔
- میں PRs کا جائزہ لینے اور انہیں ضم کرنے کے لیے معاونین بھی تلاش کر رہا ہوں۔ اگر آپ کو Git کی مزید اعلی سطح کی مشق کرنی ہے، تو [مینٹینر کی گائیڈ](</maintainer_guide.md>) پڑھیں، ہمارے [ڈسکارڈ سرور](https://discord.gg/tWkvS4ueVF) میں شامل ہوں، اور پروجیکٹ مینٹینرز سے ٹیم میں شامل ہونے کی درخواست کریں۔

[↑ اوپر جائیں ↑](#quick-access-index)

---
### شکریہ

اس پروجیکٹ کو [روشَن جوسی](https://github.com/Roshanjossey) کے بہترین [پہلے-تعاون](https://github.com/Roshanjossey/first-contributions) پروجیکٹ کے عمدہ ٹیوٹوریل سے بہت زیادہ متاثر کیا گیا ہے۔

یہ خاص طور پر [#GoogleUdacityScholars](https://twitter.com/hashtag/GoogleUdacityScholars?src=hash) کی بہترین کمیونٹی سے بھی متاثر ہے۔ گوگل چیلنج اسکالرشپ: فرنٹ اینڈ ویب ڈیولپمنٹ، کلاس آف 2017 یورپ۔

### لائسنس

اس پروجیکٹ کو [MIT لائسنس](./LICENSE) کے تحت لائسنس یافتہ کیا گیا ہے۔

### ٹاپ 100 معاونین

[![GitHub Contributors Image](https://contrib.rocks/image?repo=Syknapse/Contribute-To-This-Project)](https://github.com/Syknapse/Contribute-To-This-Project/graphs/contributors)

[اوپر واپس جائیں &uparrow;](#introduction)

[twit]: https://twitter.com/intent/tweet?text=Contribute%20To%20This%20Project.%20An%20easy%20project%20for%20first-time%20contributors,%20with%20a%20full%20tutorial.%20By%20@Syknapse&url=https://github.com/Syknapse/Contribute-To-This-Project&hashtags=100DaysofCode 'اس پروجیکٹ کے بارے میں ٹویٹ کریں'
