README.pus.md

لومړنۍ مرستې

د دې پروژې موخه دا ده چې د پیل کونکو لپاره د دوی لومړنۍ مرسته کولو لاره ساده او لارښود کړي. که تاسو د خپلې لومړۍ مرستې په لټه کې یاست، لاندې مرحلې تعقیب کړئ.

که تاسو د کمانډ لاین (CLI) سره راحته نه یاست ، دا لارښوونې وکاروئ ترڅو پوه شئ چې د GUI وسیلو کارولو څرنګوالی.

که تاسو git نصب نلرئ له دې ځایه نصب کړئ.

د دې ریپوزیتوری فورک کړئ

د دې پاڼې په سر کې د Fork تڼۍ په کلیک کولو سره دا ذخیره فورک کړئ. دا به ستاسو په حساب کې د دې ذخیره کاپي رامینځته کړي.

فورک شوی ریپازیتوری کلون Clone کړئ

اوس خپل ماشین ته د فورک شوي ذخیره کلون کړئ. خپل GitHub حساب ته لاړ شئ، د فورک شوي ریپازیتوری خلاص کړئ، د Code تڼۍ باندې کلیک وکړئ او بیا د کلپ بورډ ته د Copy To Clipboard باندې کلیک وکړئ.

بیا یو ټرمینل خلاص کړئ او لاندې کمانډ چل کړئ:

git clone "url you just copied"

چیرته چې "url you just copied" (پرته د نرخ نښه) د دې ریپازیتوری url دی (ستاسو د دې پروژې فورک). د url ترلاسه کولو لپاره مخکیني ګامونه وګورئ.

د مثال په توګه:

git clone https://github.com/this-is-you/first-contributions.git

چیرته چې 'this-is-you' ستاسو د GitHub کاربری نوم دی. دلته تاسو خپل کمپیوټر ته په GitHub کې د لومړۍ مرستې ذخیره مینځپانګې کاپي کوئ.

یوه څانګه جوړه کړئ

په خپل کمپیوټر کې د ریپوزیتوری لارښود ته بدل کړئ (که تاسو دمخه نه لرئ):

cd first-contributions

اوس د git switch کمانډ په کارولو سره څانګه جوړه کړئ:

git checkout -b your-new-branch-name

د مثال په توګه:

git checkout -b add-alonzo-church

اړین بدلونونه وکړئ او دا بدلونونه Commit کړئ

اوس د Contributors.md فایل په متن ایډیټر کې خلاص کړئ، خپل نوم پکې اضافه کړئ. دا د فایل په پیل یا پای کې مه اضافه کړئ. په منځ کې هر ځای کېږدئ. اوس، فایل ذخیره کړئ.

که تاسو د پروژې موقعیت ته لاړ شئ او د git status کمانډ اجرا کړئ ، نو تاسو به وګورئ چې بدلونونه شتون لري.

د git add کمانډ په کارولو سره دا بدلونونه په هغه څانګه کې اضافه کړئ چې تاسو یې رامینځته کړی:

git add Contributors.md

اوس دا بدلونونه د git commit کمانډ په کارولو سره ترسره کړئ:

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

د خپل نوم سره بدل کړئ.

GitHub ته بدلونونه فشار (Push) وکړئ

د 'git push' کمانډ په کارولو سره خپل بدلونونه فشار (Push) وکړئ:

git push origin <add-your-branch-name>

د your-branch-name بدلول د هغه څانګې نوم سره چې تاسو مخکې جوړ کړی:

خپل بدلونونه د بیاکتنې لپاره وسپارئ

که تاسو په GitHub کې خپل ریپازیتوری ته لاړ شئ، نو تاسو به د Compare & pull request تڼۍ وګورئ. په هغه تڼۍ کلیک وکړئ.

اوس د پلولو غوښتنه (Pull Request) وسپارئ.

ډیر ژر به زه ستاسو ټول بدلونونه د دې پروژې په اصلي څانګه کې یوځای کړم. تاسو به د خبرتیا بریښنالیک ترلاسه کړئ کله چې بدلونونه یوځای شي.

راتلونکی څه شی دی

مبارک شه! تاسو یوازې د معیاري فورک(Fork)، کلون(Clone)، ایډیټ(Edit)، او پلولو غوښتنې (Pull Request) کاري فلو بشپړ کړی چې تاسو به ډیری وختونه د مرسته کونکي په توګه ورسره مخ شئ!

خپله ونډه ولمانځئ او له خپلو ملګرو او پیروانو سره یې شریک کړئ دلته لاړ شئ.

همدارنګه، تاسو کولی شئ زموږ د Slack ټیم سره یوځای شئ که تاسو کومې مرستې ته اړتیا لرئ یا کومه پوښتنه لرئ. دلته کلیک وکړی

اوس راځئ چې تاسو په نورو پروژو کې د مرستې سره پیل وکړو. موږ د اسانه مسلو سره د پروژو لیست ترتیب کړی چې تاسو یې پیل کولی شئ. بشپړ ی وګوره

نور معلومات

د-نورو-وسیلو-کارولو-لارښوونې

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