>**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** هي مبادرة لتنظيم عمليات اختيار سهلة من المشاريع الشائعة، حتى يتمكن المطورون الذين لم يساهموا مطلقًا في المصادر المفتوحة من البدء بسرعة.

موقع الويب: [good-first-issues.github.io](https://good-first-issues.github.io)

يستهدف موقع الويب هذا في المقام الأول المطورين الذين يرغبون في المساهمة في البرامج مفتوحة المصدر ولكنهم لا يعرفون من أين أو كيف يبدأون.

يتطلع القائمون على صيانة المصادر المفتوحة دائمًا إلى إشراك المزيد من الأشخاص، لكن المطورين الجدد يعتقدون عمومًا أنه من الصعب أن تصبح مساهمًا. نحن نؤمن بأن جعل المطورين يقومون بإصلاح المشكلات فائقة السهولة يزيل حاجز المساهمات المستقبلية. هذا هو سبب وجود *القضايا الأولى الجيدة*.

## إضافة مشروع جديد

نرحب بإضافة مشروع جديد في *Good First Issues*، ما عليك سوى اتباع الخطوات التالية:

- للحفاظ على جودة المشاريع في *الإصدارات الجيدة الأولى*، يرجى التأكد من أن مستودع GitHub الخاص بك يلبي المعايير التالية:

     - يحتوي على ثلاث أعداد على الأقل تحمل تصنيف "الإصدار الأول الجيد". هذه التسمية موجودة بالفعل في جميع المستودعات بشكل افتراضي.

     - يحتوي على `README.md` مع تعليمات الإعداد التفصيلية للمشروع

     - تتم صيانته بشكل نشط (آخر تحديث منذ أقل من شهر واحد)

- أضف مسار المستودع الخاص بك (بالتنسيق "المالك/الاسم" والترتيب المعجمي) في [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json).

- إنشاء طلب سحب جديد. يرجى إضافة الرابط إلى صفحة المشكلات الخاصة بالمستودع في وصف العلاقات العامة. بمجرد دمج طلب السحب، ستكون التغييرات متاحة على [good-first-issues.github.io](https://good-first-issues.github.io).

## كيف يعمل؟

- أولاً *Good First Issues* هو موقع ويب ثابت يستخدم [PHP](https://www.php.net)` لإنشاء ملفات HTML.
- نستخدم [GitHub REST API](https://docs.github.com/en/rest) لجلب المشكلات من المستودعات المدرجة في [repositories.json](https://github.com/gomzyakov/good-first -issue/blob/main/repositories.json).
- للتنقل بين المشكلات بشكل دوري (مرتين يوميًا)، نستخدم [GitHub Workflow](https://docs.github.com/en/actions/using-workflows).

## ساعدنا على النمو

يمكن أن يكون التنقل في المشاريع مفتوحة المصدر أمرًا مرهقًا للغاية بالنسبة للمبتدئين والمساهمين ذوي الخبرة على حدٍ سواء. تتطلع *Good First Issues* إلى حل هذه المشكلة من خلال توفير منصة تعمل كنقطة بداية لأولئك الذين يتطلعون إلى البدء في استخدام المصادر المفتوحة أو أولئك الذين يتطلعون إلى الدخول في مشروع جديد.

كلما زاد عدد الأشخاص الذين يعرفون عن [good-first-issues.github.io](https://good-first-issues.github.io)، كلما كان ذلك أفضل. هناك طرق مختلفة يمكنك من خلالها مساعدتنا على النمو: يمكنك المساهمة في القوائم "الرائعة"، والتدوين عنا، والتواصل مع المدونين، والتأثيرات التقنية، والمطورين، والمصادر المفتوحة على Twitter وYouTube، على سبيل المثال. حاول ذكر [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).
