هڪ منصوبي ۾ هڪ حصو ڏيو

What this lesson is about

اهڙو مسئلو چونڊيو جيڪو توهان ٻيهر پيدا ڪري سگهو، ننڍڙو تبديلي ٽيسٽ سان گڏ موڪليو، ۽ جائزي جي مرحلي جو جواب ڏيو.

هڪ منصوبو جيڪو توهان استعمال ڪندا آهيو، ان ۾ هڪ ڪم کليل آهي: هڪ دستاويزي صفحو ڀوجپوري ۾ ترجمو ڪرڻو آهي. توهان جو آچر خالي آهي. پهريون ڇا؟

Why this matters

GitHub جو پنهنجو رهنما چوي ٿو ته fork مان حصو ڏيڻ جا ڇهه قدم آهن، جن مان پنج قدم ڪجهه لکڻ کان اڳ ٿين ٿا. هر منصوبي جي CONTRIBUTING فائل ٻڌائي ٿي ته ڪهڙا مسئلا نون ايندڙن لاءِ کليل آهن ۽ pull request ۾ ڇا هجڻ گهرجي. هڪ وڏو کليل منصوبو صاف چوي ٿو: جيڪڏهن توهان جو حل هڪ لائن ۾ ٿي سگهي ٿو، ته ان کي هڪ لائن ۾ رکو.

توهان CONTRIBUTING پڙهي هڪ کليل مسئلو وٺي، تبديلي تائين جيڪو منصوبي ۾ شامل ٿي وڃي، وٺي سگهو ٿا.

CONTRIBUTING پڙهو، مسئلو ٻيهر پيدا ڪريو، ۽ فائل کي ڇهڻ کان اڳ ان کي وٺڻ جو اعلان ڪريو.
ننڍڙو تبديلي موڪليو جيڪو مسئلو حل ڪري، هڪ اهڙي ٽيسٽ سان جيڪا بغير ان تبديلي جي ناڪام ٿئي.
PR ۾ لکيو ته ڇا تبديل ٿيو ۽ ڇو؛ جائزي جون تبصرا ڪم آهن، انڪار نه.

Task

منصوبي جي مسئلن جي فهرست ۾ هڪ ڪميونٽي ڪم آهي: هڪ دستاويزي صفحو پنهنجي ٻوليءَ ۾ ترجمو ڪريو.

Weak approach هڪ ئي رات ۾ چار صفحا ترجمو ڪري هڪ PR ۾ وجهي ڇڏيو. ڪو مسئلو ورتو نه ويو. منصوبي جي فائل هڪ PR ۾ هڪ صفحو گهرندي آهي، ۽ ٽي هفتا ڪو جائزو نٿو وٺي.

Stronger approach CONTRIBUTING پڙهڻ، مسئلي تي تبصرو ڪري هڪ صفحو وٺڻ، ۽ fork جي هڪ برانچ ۾ ڪم ڪرڻ. commit پيغام ۾ صفحي جو نالو ۽ مسئلي جو نمبر آهي. PR ٻڌائي ٿو ڪهڙو صفحو، پراڻو لفظ پڙهندڙ کي ڪيئن گمراهه ڪري ٿو، ۽ تعمير ڪيئن چيڪ ڪئي وئي. جائزو ڏيندڙ ٻه لفظ تبديل ڪرڻ لاءِ چوندو آهي، ۽ اهو ايندڙ ڏينهن شامل ٿي وڃي ٿو.

Why the stronger approach works ٻئي تقريباً برابر لکيو. صرف هڪ ئي منصوبي جي فائل جي پيروي ڪئي، تنهنڪري صرف هڪ وٽ شامل ٿيل تبديلي آهي.

Try a changed situation توهان جو چاچو چوندو آهي ته دڪان جي ڇپيل قيمتن جي فهرست ۾ فون نمبر غلط آهي، ٻيهر ڇپڻ کان اڳ درست ڪريو. توهان ڇا تبديل ڪندا؟

Make something yourself هڪ کليل منصوبي ۾ هڪ حقيقي حصو ڏيو. ٻڌايو: ڪهڙو مسئلو، ڪهڙي فائل تبديل ڪئي، ڪهڙي ٽيسٽ ڪئي، توهان جي PR ۾ ڇا لکيل هو، ۽ جائزي ۾ ڇا گهرجي ويو.

Read the primary or official source: GitHub Docs · Creating a pull request from a fork