إرشادات الإبلاغ عن المشاكل

تقارير الأخطاء والميزات الجديدة الفعالة حاسمة لتطوير XOOPS. يساعدك هذا الدليل على إنشاء مشاكل عالية الجودة.

قبل الإبلاغ

تحقق من المشاكل الموجودة

ابحث دائماً أولاً:

انتقل إلى مشاكل GitHub
ابحث عن كلمات مفتاحية متعلقة بمشكلتك
فحص المشاكل المغلقة - قد تكون محلولة بالفعل
انظر إلى طلبات السحب - قد تكون قيد التقدم

أنواع المشاكل

تقرير خطأ

خطأ هو سلوك غير متوقع أو عيب.

أمثلة:

تسجيل الدخول لا يعمل
أخطاء قاعدة البيانات
التحقق من النموذج المفقود
ثغرة أمنية

طلب ميزة جديدة

طلب ميزة جديدة هو اقتراح لوظيفة جديدة.

أمثلة:

أضف دعم ميزة جديدة
تحسين الوظيفة الموجودة
إضافة التوثيق المفقود
تحسينات الأداء

الإبلاغ عن خطأ

قالب تقرير الخطأ

## الوصف
وصف موجز وواضح للخطأ.

## خطوات إعادة الإنتاج
1. الخطوة الأولى
2. الخطوة الثانية
3. الخطوة الثالثة

## السلوك المتوقع
ما الذي يجب أن يحدث.

## السلوك الفعلي
ما الذي يحدث بالفعل.

## البيئة
- إصدار XOOPS: X.Y.Z
- إصدار PHP: 8.2/8.3/8.4
- قاعدة البيانات: MySQL/MariaDB الإصدار
- نظام التشغيل: Windows/macOS/Linux
- المتصفح: Chrome/Firefox/Safari

## لقطات الشاشة
إذا كان قابلاً للتطبيق، أضف لقطات تظهر المشكلة.

## السياق الإضافي
أي معلومات أخرى ذات صلة.

## الإصلاح المحتمل
إذا كان لديك اقتراحات لإصلاح المشكلة (اختياري).

الإبلاغ عن طلب ميزة

قالب طلب الميزة الجديدة

## الوصف
وصف واضح وموجز للميزة.

## بيان المشكلة
لماذا هذه الميزة مطلوبة؟ ما المشكلة التي تحلها؟

## الحل المقترح
وصف التطبيق المثالي أو واجهة المستخدم.

## البدائل المدروسة
هل هناك طرق أخرى لتحقيق هذا الهدف؟

## السياق الإضافي
أي نماذج أولية أو أمثلة أو مراجع.

## التأثير المتوقع
كيف ستستفيد المستخدمون؟ هل ستكون تغييراً فاصلاً؟

مشاكل الأمان

لا تبلغ علناً

لا تنشر أبداً مشكلة تقرير أمني علناً.

أبلغ بشكل خاص

أرسل بريداً إلى فريق الأمان: security@xoops.org
أدرج:
- وصف الثغرة
- خطوات إعادة الإنتاج
- التأثير المحتمل
- معلومات الاتصال بك

الإفصاح المسؤول

سنقر بالاستقبال في غضون 48 ساعة
سنقدم تحديثات كل 7 أيام
سننسق توقيت الإفصاح العام

أسماء المشاكل الجيدة

أمثلة جيدة

✅ صفحة تسجيل الدخول تظهر صفحة فارغة عند فشل اتصال قاعدة البيانات
✅ إضافة دعم المصادقة متعددة العوامل
✅ منع حقن SQL في حقل الاسم
✅ تحسين أداء استعلام قائمة المستخدمين
✅ تحديث التوثيق الخاص بالتثبيت لـ PHP 8.2

أمثلة سيئة

❌ خطأ في النظام
❌ ساعدني!!
❌ لا يعمل
❌ سؤال حول XOOPS
❌ خطأ

إرشادات الاسم

كن محدداً - اذكر ما وأين
كن موجزاً - أقل من 75 حرف
استخدم الزمن الحاضر - “يظهر صفحة فارغة” وليس “أظهرت صفحة فارغة”
أدرج السياق - “في لوحة التحكم” و”أثناء التثبيت”
تجنب الكلمات العامة - ليس “إصلاح” أو “مساعدة” أو “مشكلة”

أفضل ممارسات وصف المشكلة

أدرج المعلومات الأساسية

ماذا - وصف واضح للمشكلة
أين - أي صفحة أو وحدة أو ميزة
متى - خطوات إعادة الإنتاج
البيئة - الإصدار والنظام والمتصفح
لماذا - لماذا هذا مهم

استخدم تنسيق الأكواد

رسالة الخطأ: `خطأ: لا يمكن العثور على المستخدم`

مقتطف الكود:
```php
$user = $this->getUser($id);
if (!$user) {
    echo "خطأ: لا يمكن العثور على المستخدم";
}

### أدرج لقطات الشاشة

لمشاكل واجهة المستخدم، أدرج:
- لقطة الشاشة للمشكلة
- لقطة الشاشة للسلوك المتوقع
- شرح بالحواشي

### استخدم التسميات

أضف تسميات لتصنيف:
- `bug` - تقرير خطأ
- `enhancement` - طلب تحسين
- `documentation` - مشكلة التوثيق
- `help wanted` - البحث عن المساعدة
- `good first issue` - جيد للمساهمين الجدد

---

## بعد الإبلاغ

### كن مستجيباً

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

### اتبع الآداب

- كن محترماً واحترافياً
- افترض النوايا الحسنة
- لا تطالب بالإصلاحات - المطورون متطوعون
- عرض المساعدة إن أمكن
- شكر المساهمين على عملهم

---

## التوثيق ذات الصلة

- قواعس السلوك
- سير عمل المساهمة
- إرشادات طلب السحب
- نظرة عامة على المساهمة

---

#xoops #issues #bug-reporting #feature-requests #github