مرحباً! ؟؟
Good First Issue هي مبادرة لتنظيم عمليات اختيار سهلة من المشاريع الشائعة، بحيث يمكن للمطورين الذين لم يساهموا مطلقًا في المصادر المفتوحة البدء بسرعة.
يتطلع القائمون على صيانة المصادر المفتوحة دائمًا إلى إشراك المزيد من الأشخاص، لكن المطورين الجدد يعتقدون عمومًا أنه من الصعب أن تصبح مساهمًا. نحن نؤمن بأن جعل المطورين يقومون بإصلاح المشكلات فائقة السهولة يزيل حاجز المساهمات المستقبلية. هذا هو سبب وجود العدد الأول الجيد.
نرحب بإضافة مشروع جديد في الإصدار الأول الجيد، ونحن نشجع جميع المشاريع - القديمة والجديدة، الكبيرة والصغيرة.
اتبع هذه الخطوات البسيطة:
هدفنا هو تضييق نطاق المشاريع للمساهمين الجدد مفتوحي المصدر. للحفاظ على جودة المشاريع في الإصدار الأول الجيد، يرجى التأكد من أن مستودع GitHub الخاص بك يلبي المعايير التالية:
يحتوي على ثلاث مشكلات على الأقل مع تصنيف good first issue . هذه التسمية موجودة بالفعل في جميع المستودعات بشكل افتراضي. إذا لم يكن الأمر كذلك، يمكنك اتباع الخطوات هنا.
لديها ما لا يقل عن 10 المساهمين.
فهو يحتوي على README.md مع تعليمات الإعداد التفصيلية للمشروع، وCONTRIBUTING.md مع إرشادات للمساهمين الجدد.
يتم صيانته بنشاط.
أضف مسار المستودع الخاص بك (بالترتيب المعجمي) في data/repositories.toml.
إنشاء طلب سحب جديد. يرجى إضافة الرابط إلى صفحة المشكلات الخاصة بالمستودع في وصف العلاقات العامة. بمجرد دمج طلب السحب، ستكون التغييرات متاحة على موقع goodfirstissue.dev.
يحتوي الإصدار الأول الجيد على مكونين - تطبيق الواجهة الأمامية المبني باستخدام Nuxt.js والبرنامج النصي لتجميع البيانات المكتوب بلغة Python.
للمساهمة في ميزات وتغييرات جديدة على موقع الويب، قد ترغب في تشغيل التطبيق محليًا. يرجى اتباع الخطوات التالية:
استنساخ المشروع محليا. تأكد من تثبيت Python 3 وإصدار حديث من Node.js على جهاز الكمبيوتر الخاص بك.
قم بعمل نسخة من نماذج ملفات البيانات ليستخدمها تطبيقك المحلي وأعد تسميتها إلى اسم الملف الذي يتوقعه التطبيق. هذه الخطوة مهمة، لأن تطبيق الواجهة الأمامية لن يعمل بدون ملفات البيانات هذه.
$ cp data/generated.sample.json data/generated.json $ cp data/tags.sample.json data/tags.json
أنشئ تطبيق الواجهة الأمامية وابدأ تشغيل خادم التطوير.
تثبيت $ Bun # تثبيت التبعيات $ Bun dev # بدء تشغيل خادم التطوير
يجب أن يفتح التطبيق في متصفحك.
