المساهمة والأمن

أهلاً بكم

ينمو رفيق حين يساعد الناس بعضهم بعضاً. سواء كنتم تطورون البرمجيات، أو تدربون، أو تدرسون الرياضة، أو تترجمون، أو تختبرون، أو تكتبون، أو لاحظتم ببساطة ما يمكن توضيحه أكثر، نرحب بوجهة نظركم. لا يلزم أن تبدأوا بميزة كبيرة أو أن تعرفوا كل تفاصيل المشروع.

كل مساهمة مفيدة، مهما كانت بسيطة: تحسين جملة، مراجعة ترجمة عربية، الإبلاغ عن خطوة محيرة، تجربة مسار ببيانات آمنة تجريبية أو اقتراح تحسين قادم. يمكنكم استكشاف الشيفرة والمشاركة عبر مستودع رفيق.

خطوة أولى سهلة

قبل تعديل الشيفرة، اطلعوا على دليل المساهمة والمتطلبات وقرارات التصميم ذات الصلة. وإذا أردتم تشغيل المشروع، اتبعوا دليل البدء. ابدؤوا بتغيير محدد واشرحوا ما جربتموه وما لاحظتموه.

إن لم تعرفوا من أين تبدؤون، اكتبوا ببساطة ما الذي أردتم فعله، وما الذي حدث، وكيف يمكن تكراره؛ فهذا يمنح الفريق بداية مفيدة. استخدموا بيانات تجريبية في الأمثلة.

الشيفرة والتوثيق والترجمة

أبقوا التحقق من الصلاحيات والمعاملات على الخادم، واستخدموا ترحيلات أمامية، وأعيدوا توليد أنواع النقل من مصدرها. عند تغير السلوك أو الحدود المعروفة، حدّثوا التوثيق المعتمد أيضاً. يدعم رفيق العربية والإنجليزية، لذا يرجى تحديث الصفحات والنصوص المترجمة معاً. وفي هذا الموقع العام، حافظوا على اقتران المسارات ومفاتيح الترجمة بين اللغتين.

الفحوص ومشاركة العمل

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

ملاحظة حول الإبلاغ الأمني

نقدّر من يساعد في إبقاء رفيق آمناً. يرجى اتباع إرشادات أمن المشروع. إذا كان الإبلاغ الخاص عن الثغرات مفعلاً، استخدموا GitHub Security ← Advisories ← Report a vulnerability. وإن لم يكن مفعلاً، اطلبوا من المشرفين علناً قناة خاصة من دون نشر تفاصيل الاستغلال. لا ترسلوا أدلة حساسة عبر نموذج التواصل العام. لا توجد مهلة مضمونة للرد.

سعداء بانضمامكم

شكراً لمشاركة وقتكم وأفكاركم. قد تجعل مساهمتكم رفيق أسهل أو أوضح أو أنفع للمدرب أو الرياضي أو المؤسسة التالية.

المصدر والنطاق

رُوجع وفق الفرع الجامعي المحلي الحالي في 17 أكتوبر 2026. CONTRIBUTING.md.