کسی پروجیکٹ میں ایک تعاون کریں

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 میں بتایا گیا کون سا صفحہ، پرانے الفاظ نے قاری کو کیسے گمراہ کیا، اور بلڈ کیسے چیک کیا گیا۔ جائزہ لینے والے نے دو الفاظ بدلنے کو کہا، اور اگلے دن merge ہو گیا۔

Why the stronger approach works دونوں نے تقریباً برابر لکھا۔ صرف ایک نے پروجیکٹ کی فائل کی پیروی کی، اس لیے صرف اسی کا merge ہوا نتیجہ ہے۔

Try a changed situation آپ کے چچا کہتے ہیں کہ دکان کی چھپی ہوئی قیمتوں کی فہرست میں فون نمبر غلط ہے، دوبارہ چھپنے سے پہلے درست کر دو۔ آپ کیا بدلیں گے؟

Make something yourself کسی کھلے پروجیکٹ میں ایک حقیقی تعاون کریں۔ بتائیں: کون سا مسئلہ، کون سی فائل بدلی، کون سا ٹیسٹ چلایا، آپ کے PR میں کیا لکھا تھا، اور جائزہ میں کیا مانگا گیا۔

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