تطوير المشروع

دليل للمطورين الراغبين في المساهمة في تطوير مشروع "دليل" وتحسينه.

خارطة طريق المشروع

نظرة عامة على خطط تطوير المشروع المستقبلية:

• الأهداف قصيرة المدى:

  • تحسين وتوسيع المستندات الحالية
  • إضافة المزيد من الأمثلة العملية لكل قسم
  • ترجمة المحتوى الأساسي إلى اللغة الإنجليزية

• الأهداف متوسطة المدى:

  • تطوير أداة تفاعلية لمقارنة النماذج العربية
  • إنشاء مكتبة للتوجيهات المحسنة للغة العربية
  • بناء مجتمع نشط للمساهمين

• الأهداف طويلة المدى:

  • إنشاء منصة تعليمية متكاملة للنماذج اللغوية العربية
  • تطوير معايير تقييم خاصة باللغة العربية
  • دعم البحث والتطوير في مجال النماذج اللغوية العربية

التواصل مع الفريق

قنوات وطرق التواصل مع فريق تطوير المشروع:

• قنوات الاتصال:

  • مجموعة Slack: [رابط مجموعة Slack]
  • قائمة بريدية: contributors@daleel-ai.org
  • اجتماعات المجتمع: كل أسبوعين يوم الخميس

• الاستفسارات والدعم:

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

• عملية الإرشاد للمساهمين الجدد:

  • برنامج توجيه للمساهمين الجدد
  • جلسات توجيهية أسبوعية
  • موارد تعليمية للمبتدئين

تقديم المقترحات والتحسينات

إرشادات حول تقديم المقترحات والمساهمة في تحسين المشروع:

• تقديم اقتراح أو فكرة:

  1. التحقق من أن الفكرة لم تُطرح سابقًا في قائمة المشكلات
  2. إنشاء مشكلة جديدة بوصف تفصيلي للاقتراح
  3. استخدام نموذج "اقتراح ميزة" المتوفر
  4. الإشارة إلى الفوائد المتوقعة والجمهور المستهدف

• نموذج اقتراح:

  ## وصف الاقتراح
  [وصف مفصل للميزة أو التحسين المقترح]
  
  ## المشكلة التي يحلها
  [شرح المشكلة الحالية التي سيعالجها هذا الاقتراح]
  
  ## الحل المقترح
  [تفاصيل الحل المقترح وكيفية تنفيذه]
  
  ## فوائد التنفيذ
  [قائمة بالفوائد المتوقعة من تنفيذ هذا الاقتراح]
  
  ## الموارد اللازمة
  [تقدير للموارد اللازمة لتنفيذ الاقتراح]

• عملية مراجعة المقترحات:

  • مراجعة أولية من الفريق الأساسي خلال أسبوع
  • النقاش المجتمعي للأفكار المقبولة
  • التصويت على المقترحات ذات الأولوية
  • إضافة المقترحات المقبولة إلى خارطة الطريق

آلية المساهمة التقنية

خطوات المساهمة في كود المشروع وتحسيناته التقنية:

• إعداد بيئة التطوير:

  # استنساخ المستودع
  git clone https://github.com/daleel-ai/daleel.git
  cd daleel
  
  # تثبيت التبعيات
  npm install
  
  # تشغيل الخادم المحلي
  npm start

• إرشادات الترميز:

  • اتباع معايير التنسيق المحددة في .prettierrc
  • كتابة اختبارات لأي ميزات جديدة
  • استخدام TypeScript للكود الجديد
  • توثيق الوظائف والمكونات الجديدة

• عملية تقديم الكود:

  1. إنشاء فرع جديد لكل ميزة أو إصلاح
  2. الالتزام برسائل Git واضحة ووصفية
  3. التأكد من نجاح جميع الاختبارات
  4. تقديم طلب سحب مع وصف تفصيلي للتغييرات
  5. الرد على تعليقات المراجعة وإجراء التعديلات اللازمة