دليل المساهم

حُل مشكلة واحدة. اقصر تغييراتك على مشكلة أو ميزة واحدة.

اشرح ما الذي تغيّر ولماذا. أضف السياق، ولقطات الشاشة عند الحاجة، واربط المشكلة.

تأكد من أن كودك يعمل كما هو متوقع ولا يكسر الوظائف القائمة.

اجعله صغيرًا ونظيفًا. بلا تغييرات في التنسيق ولا إعادة هيكلة غير ذات صلة.

حافظ على اتساق الكود مع المشروع.

ابنِ أجزاء مرنة وقابلة للتركيب.

اتبع اصطلاحات التسمية.

حافظ على خفة المشروع.

فكّر في حالات الخطأ والسيناريوهات.

حافظ على نظافة الكود وبساطته.

تأكد من أن كل شيء يعمل.

ساعد الآخرين على فهم تغييراتك.

تحسين التنفيذ أو إصلاح المشكلات.

أضف تغطية الاختبار أو حسّنها.

حدّث الوثائق أو التعليقات أو ملفات README.

قدّم سياقًا أو شرحًا أوضح.

ناقش حلولًا بديلة.

عامِل المساهمين والمشرفين باحترام.

أشِر إلى المشكلات وساعد في إيجاد الحلول.

اشرح تفكيرك.

شارك ما تعرفه.

اجعل النقاشات ذات صلة.

اطرح سؤالًا واحصل على المساعدة من الآخرين.

شارك الأفكار والمقترحات.

تبنَّ المشكلات وساهم فيها.

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

أبلغ عن الأخطاء وناقش الإصلاحات.

عالق؟ اسأل المجتمع.