شهر رمضان هو شهر القرآن، وللمطورين والمبرمجين فرصة عظيمة لنيل أجر "الصدقة الجارية" من خلال المساهمة في المشاريع التقنية الخادمة لكتاب الله. ولضمان أن تكون مساهمتك فعّالة ومُرحبًا بها في مجتمع المصادر المفتوحة (Open Source)، جمعنا لكم "أدبيات المساهمة في المشاريع مفتوحة المصدر" في خطوات عملية تسهّل عليكم وعلى أصحاب المشاريع قبول المساهمات:
خطوات المساهمة الناجحة 🚀
1. ابدأ بالتواصل: تصفح قائمة المشاكل (Issues)، وعندما تجد مشكلة تمتلك المهارة لحلها، اترك تعليقاً لصاحب المشروع توضح فيه رغبتك بالعمل عليها.
2. انتظر الضوء الأخضر: لا تبدأ العمل فوراً، بل انتظر حتى يقوم صاحب المشروع بتعيينك (Assign) على المهمة؛ لتجنب تضارب العمل مع مطور آخر.
3. جهز بيئة العمل: قم بعمل "Fork" للمشروع، ثم أنشئ "Branch" جديد مخصص لهذه التعديلات فقط.
4. ابدأ التطوير: قم بكتابة الكود وحفظ التعديلات (Commits) على الفرع الذي أنشأته.
5. اختبر عملك: قبل التسليم، تأكد تماماً أن المشروع يعمل بنجاح على بيئتك التطويرية، وأنك نفذت المطلوب بدقة دون التأثير على بقية الخواص.
6. أرسل طلب الدمج (PR): اطلب Pull Request إلى المستودع الأصلي، واحرص في الوصف على ذكر أن هذا الطلب يحل Issue رقم (كذا) أو يضيف الميزة الفلانية.
7.كن صبوراً ومتعاونًا: انتظر مراجعة الكود (Code Review) من صاحب المشروع. تقبّل الملاحظات بصدر رحب، وناقشه في التعليقات، والتزم بإجراء التعديلات المطلوبة حتى يصل الكود للمستوى المطلوب.
- في الختام: سيوافق صاحب المشروع ويدمج تعديلاتك (Merge) لتصبح جزءاً من المشروع.
بعد قبول تعديلاتك ودمجها في المشروع، سيصبح إسهامك جزءًا من أثرٍ رقمي يخدم القرآن الكريم، ويكتب لك أجر مستمر لما بعد شهر رمضان إن شاء الله
مفاهيم سريعة لمن يساهم لأول مرة 💡
إذا كنت مبرمجاً وتفهم الكود جيداً لكن لم يسبق لك التعامل مع Github أو git flow، إليك تبسيطاً لهذه المصطلحات:
- الفورك (Fork): هي ببساطة "نسخة طبق الأصل" من المشروع تأخذها إلى حسابك الشخصي لتعبث بها كما تشاء دون أن تخشى تخريب المشروع الأصلي. عندما تساهم على مشاريع مفتوحة المصدر لا تمتلك إمكانيّة النشر عليها مباشرة، عليك إنشاء Fork قبل كلّ شيء حتى تستطيع إرسال Commit بالتعديلات إلى غيتهب - وستحفظ في نسختك الخاصة، لا على المشروع الأصلي.
- البرانش (Branch): تخيل أن المشروع هو "جذع شجرة"، البرانش هو "غصن فرعي" تفتحه لتكتب فيه كود ميزة محددة أو إصلاح خطأ معين. هذا يعزل تعديلاتك عن الكود الرئيسي حتى تنتهي منها تماماً. بهذا الشكل، يمكنك العمل على برانش، وطلب قبول التعديلات PR عليه، ثم متابعة العمل على برانش آخر ريثما يتم مراجعة وقبول البرانش الأول.
- طلب الدمج (Pull Request / PR): هو إشعار ترسله لصاحب المشروع الأصلي تقول له فيه: "لقد انتهيت من التعديلات في نسختي، هل يمكنك مراجعتها وسحبها (Pull) لتدمجها مع مشروعك الرسمي؟"
قائمة المشاريع المساهمة في مبادرة رمضان الأثر:
نظام إدارة المحتوى القرآني
دليل التطبيقات القرآنية
حزمة مصحف عماد (سويفت)
حزمة مصحف عماد (React Native)
حزمة مصحف عماد (كوتلن)
مصحف عماد فلاتر (IMAD Flutter)
منجّم
رتق
محرك البحث القرآني
Open Mushaf Native
Open Tarteel TV
Open Tarteel
إضافة المساعد القرآني لأوبسيديان
القرآن الشهري (Monthly Quran)
مذكّر الوِرد (Wird Reminder) (أُنجزت كلّ المهام في هذا المشروع 🎉🎉)
