README.ks.md

پہل تعاون – First Contributions

پروجیکٹک مقصد

یہ پروجیکٹ نوآموزن ہند مدد کرن تہ رہنمائی کرن خٲطرہ بنٲون آمُت چھُ، یِتھ سیتھ تِم آسانی سان پنن پہل اوپن سورس تعاون کٔرتھ ہیکن۔

اگر توہیہ پنن پہل تعاون کرُن چھاہیو، تیلے یِم نیبر دِتھ قدم فالو کرِو۔

اگر توہیہ کمانڈ لائن استعمال کرنس منز آرام دہ نِہ چھو، تیلے GUI ٹولزن سیتھ ٹیوٹوریل دستیاب چھ۔

ر Git انسٹال کرُن

اگر توہند کمپیوٹرنس پیٹھ git انسٹال نِہ چھُ، تیلے اتھ انسٹال کرِو:

https://docs.github.com/en/get-started/quickstart/set-up-git

قدم 2 – ریپوزیٹری فورک کرُن

یِہ پیجک پیٹھ موجود Fork بٹن پیٹھ کلک کرنہ سیتھ یِہ ریپوزیٹری فورک کرِو۔
یِمن عملہ سیتھ یِہ ریپوزیٹری ہُنٛد نقل توہند GitHub اکاؤنٹس منز بنِہ۔

قدم 3 – ریپوزیٹری کلون کرُن

ونہِ فورک کرمت ریپوزیٹری پننس کمپیوٹرنس پیٹھ کلون کرِو۔

پننس GitHub اکاؤنٹس منز گژھِو، فورک کرمت ریپوزیٹری کھولِو، “Code” بٹن پیٹھ کلک کرِو، SSH ٹیب ژارِو تہ URL کاپی کرِو۔

ٹرمنل کھولِو تہ یِہ کمانڈ چلٲو:

git clone "url you just copied"

مثال: ```bash git clone git@github.com:this-is-you/first-contributions.git ```

یتھہ this-is-you توہند GitHub یوزرنیم چھُ۔

قدم 4 – نوو برانچ بنٲوُن

ریپوزیٹری ڈائریکٹری منز گژھِو:

cd first-contributions

نوو برانچ بنٲوِو:

git switch -c your-new-branch-name

مثال:

git switch -c add-alonzo-church

اگر یِمۍ تُہۍ git switch استعمال کران وِز کُنہِ غلطی آیہٕ، یَتھ پٲٹھۍ کلِک کٔرِو:

اگر غلطی پیغام "Git: switch is not a git command. See git –help" ظاہر گژھِ، تَتھٕ ہُند مطلب یہ چھُ کہ تُہۍ git ہُند پرٛان وٲژن استعمال کران چھُو۔

اَسہِ حالتس منٛز، git checkout استعمال کرُن ہُند کوشش کٔرِو:

git checkout -b your-new-branch-name

قدم 5 – تبدیلی کرُن تہ Commit کرُن

Contributors.md فایل کھولِو

اتھ منز پنُن ناو شامل کرِو

فائل محفوظ کرِو

ونہِ یِہ کمانڈ چلٲو:

git status

تبدیلی شامل کرنہ خٲطرہ:

git add Contributors.md

Commit کرنہ خٲطرہ:

git commit -m "Add your-name to Contributors list"

“your-name” بدلہ پنُن ناو لیکھِو۔

قدم 6 – تبدیلی GitHub پیٹھ Push کرُن

git push -u origin your-branch-name

“your-branch-name” بدلہ پنُن برانچک ناو لیکھِو۔

اگر push کران وِز کُنہِ غلطی آیہٕ، یَتھ پٲٹھۍ کلِک کٔرِو:

• Authentication Error

  remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.  
  remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.  
  fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'

  SSH key بنٲوُن تہ پننس اکاؤنٹس سۭتۍ configure کرُن خٲطرٕ GitHub ہُند tutorial وُچھِو۔

  اَسہِ علاوہ، remote address چیک کرُن خٲطرٕ یہ کمانڈ چَلاوُن:

  git remote -v

  اگر یہ یِمۍ پٲٹھۍ وُچھِ:

  origin	https://github.com/your-username/your_repo.git (fetch)  
  origin	https://github.com/your-username/your_repo.git (push)

  تہ یہ کمانڈ استعمال کٔرِو تام change کرُن خٲطرٕ:

  git remote set-url origin git@github.com:your-username/your_repo.git

  نَتہ تُہۍ ہنوز username تہ password خٲطرٕ prompt گژھِو تہ authentication error آیہٕ۔

پنٕنۍ تبدیلیاں جائزہ خٲطرٕ جمع کرِو

پننس GitHub ریپوزیٹری پیٹھ گژھِو، تہ توہیہ Compare & pull request بٹن وُچھِو۔

اتھ پیٹھ کلک کرِو تہ pull request جمع کرِو۔

ژٹہِ وقتس منز توہند تبدیلی مین برانچس سیتھ مرج گژھن۔ توہیہ ای میل نوٹیفکیشن رَٹِو جب تبدیلی منظور گژھِتھ۔

یِتھہ پتہ کِتھ گژھن؟

مبارک! 🎉 توہیہ کامیابی سان معیاری ورک فلو مکمل کرمُت:

fork → clone → edit → pull request

یُس اوپن سورس دنیاس منز عام طور استعمال گژھان چھُ!

مزيد مشق

اگر توہیہ مزيد مشق چھاہیو، تیلے یِہ چیک کرِو: https://github.com/roshanjossey/code-contributions

دُسریں آسان پروجیکٹن ہند فہرست: https://firstcontributions.github.io/#project-list وَڌھ مواد

GUI ٹولزن سیتھ ٹیوٹوریل

توہیہ یِم ٹول تہِ استعمال کٔرتھ ہیکو:

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA

توہند پہل اوپن سورس تعاونس خٲطرہ بہت بہت مبارک! 🚀