>**NOTE:** _This file has been translated automatically. If you find an error, just make a PR with the edits" to all translation files._
![گڈ فرسٹ ایشوز](../assets/github/social-preview.png)

# اچھے پہلے ایشوز

**گڈ فرسٹ ایشوز** مقبول پراجیکٹس سے آسان انتخاب کو درست کرنے کے لیے ایک پہل ہے، لہذا ایسے ڈویلپرز جنہوں نے کبھی بھی اوپن سورس میں تعاون نہیں کیا ہے جلدی شروع کر سکتے ہیں۔

ویب سائٹ: [good-first-issues.github.io](https://good-first-issues.github.io)

یہ ویب سائٹ بنیادی طور پر ان ڈویلپرز کو نشانہ بناتی ہے جو اوپن سورس سافٹ ویئر میں حصہ ڈالنا چاہتے ہیں لیکن نہیں جانتے کہ کہاں اور کیسے شروع کرنا ہے۔

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

## ایک نیا پروجیکٹ شامل کرنا

آپ کو *گڈ فرسٹ ایشوز* میں ایک نیا پروجیکٹ شامل کرنے کا خیرمقدم ہے، بس ان مراحل پر عمل کریں:

- *گڈ فرسٹ ایشوز* میں پروجیکٹس کے معیار کو برقرار رکھنے کے لیے، براہ کرم یقینی بنائیں کہ آپ کا GitHub ذخیرہ درج ذیل معیار پر پورا اترتا ہے:

     - اس میں 'اچھا پہلا شمارہ' لیبل کے ساتھ کم از کم تین مسائل ہیں۔ یہ لیبل پہلے سے طے شدہ طور پر تمام ریپوزٹریز پر موجود ہے۔

     - اس میں ایک `README.md` ہے جس میں پروجیکٹ کے لیے تفصیلی سیٹ اپ ہدایات ہیں۔

     - یہ فعال طور پر برقرار ہے (آخری اپ ڈیٹ 1 ماہ سے بھی کم پہلے)

- [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json) میں اپنے ریپوزٹری کا راستہ (فارمیٹ `مالک/نام` اور لغت کی ترتیب میں) شامل کریں۔

- ایک نئی پل کی درخواست بنائیں۔ براہ کرم PR تفصیل میں ریپوزٹری کے ایشوز پیج کا لنک شامل کریں۔ پل کی درخواست کے ضم ہونے کے بعد، تبدیلیاں [good-first-issues.github.io](https://good-first-issues.github.io) پر لائیو ہو جائیں گی۔

## یہ کیسے کام کرتا ہے؟

- پہلا *گڈ فرسٹ ایشوز* ایک مستحکم ویب سائٹ ہے جو HTML فائلیں بنانے کے لیے [PHP](https://www.php.net)` کا استعمال کرتی ہے۔
- ہم [repositories.json](https://github.com/gomzyakov/good-first) میں درج ذخیروں سے مسائل لانے کے لیے [GitHub REST API](https://docs.github.com/en/rest) استعمال کرتے ہیں۔ -issue/blob/main/repositories.json)۔
- وقتاً فوقتاً مسائل سے گزرنے کے لیے (دن میں دو بار)، ہم [GitHub Workflow](https://docs.github.com/en/actions/using-workflows) استعمال کرتے ہیں۔

## بڑھنے میں ہماری مدد کریں۔

اوپن سورس پروجیکٹس کو نیویگیٹ کرنا ابتدائی اور تجربہ کار شراکت داروں کے لیے یکساں طور پر زبردست ہوسکتا ہے۔ *گڈ فرسٹ ایشوز* ایک ایسا پلیٹ فارم فراہم کرکے اس مسئلے کو حل کرنے کی کوشش کرتا ہے جو اوپن سورس کے ساتھ شروعات کرنے کے خواہشمند افراد یا نئے پروجیکٹ میں شامل ہونے کے خواہاں افراد کے لیے نقطہ آغاز کے طور پر کام کرتا ہے۔

جتنے زیادہ لوگ [good-first-issues.github.io](https://good-first-issues.github.io) کے بارے میں جانتے ہیں، اتنا ہی بہتر ہے۔ مختلف طریقے ہیں جن سے آپ ہماری ترقی میں مدد کر سکتے ہیں: مثال کے طور پر، آپ `خوبصورت` فہرستوں میں حصہ ڈال سکتے ہیں، ہمارے بارے میں بلاگ بنا سکتے ہیں، بلاگرز تک پہنچ سکتے ہیں، تکنیکی اثرات، ڈویلپر اور ٹوئٹر اور یوٹیوب پر اوپن سورس، مثال کے طور پر۔ کوشش کریں اور ویڈیو یا ٹویٹ میں ذکر کردہ [good-first-issues.github.io](https://good-first-issues.github.io) حاصل کریں!

## تجاویز اور خواہشات

اگر آپ کے سوالات یا مشورے ہیں (یا کوئی بگ ملا ہے)، تو آپ ہمیشہ [مسائل](https://github.com/good-first-issues/good-first-issues.github.io/issues) پر لکھ سکتے ہیں۔

## لائسنس

یہ اوپن سورس سافٹ ویئر ہے جو [MIT لائسنس] (https://github.com/good-first-issues/good-first-issues.github.io/blob/main/LICENSE) کے تحت لائسنس یافتہ ہے۔
