Skip to content

Latest commit

 

History

History
47 lines (25 loc) · 4.78 KB

File metadata and controls

47 lines (25 loc) · 4.78 KB

الأعداد الأولى الجيدة

القضايا الأولى الجيدة

Good First Issues هي مبادرة لتنظيم عمليات اختيار سهلة من المشاريع الشائعة، حتى يتمكن المطورون الذين لم يساهموا مطلقًا في المصادر المفتوحة من البدء بسرعة.

موقع الويب: good-first-issues.github.io

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

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

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

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

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

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

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

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

  • أضف مسار المستودع الخاص بك (بالتنسيق "المالك/الاسم" والترتيب المعجمي) في repositories.json.

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

كيف يعمل؟

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

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

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

كلما زاد عدد الأشخاص الذين يعرفون عن good-first-issues.github.io، كلما كان ذلك أفضل. هناك طرق مختلفة يمكنك من خلالها مساعدتنا على النمو: يمكنك المساهمة في القوائم "الرائعة"، والتدوين عنا، والتواصل مع المدونين، والتأثيرات التقنية، والمطورين، والمصادر المفتوحة على Twitter وYouTube، على سبيل المثال. حاول ذكر good-first-issues.github.io في مقطع فيديو أو تغريدة!

الاقتراحات والرغبات

إذا كانت لديك أسئلة أو اقتراحات (أو وجدت خطأً ما)، فيمكنك دائمًا الكتابة إلى القضايا.

رخصة

هذا برنامج مفتوح المصدر مرخص بموجب ترخيص MIT.