هذا دليل للإبلاغ عن الأخطاء التي تكتشفها في Discourse باستخدام القنوات الصحيحة.
مستوى المستخدم المطلوب: يمكن لأي شخص الإبلاغ عن الأخطاء
عند مواجهة مشكلة تعطل أو تمنع الاستخدام الطبيعي لـ Discourse، من الضروري الإبلاغ عن هذا الخطأ حتى يمكن معالجته وإصلاحه. يساعد الإبلاغ عن الأخطاء في تحسين المنصة للجميع - ستوجهك هذه الوثائق خلال عملية الإبلاغ عن الخطأ بشكل فعال على Meta، وهي طريقة ممتازة لـ المساهمة في Discourse.
ملخص
في هذا الدليل، ستتعلم:
- كيفية التأكد من أن الخطأ لم يتم إصلاحه بالفعل
- كيفية التحقق من المشكلة في بيئة الاختبار الرسمية لـ Discourse
- كيفية إنشاء تقرير خطأ مفصل
التأكد من أن الخطأ لم يتم إصلاحه بالفعل
قبل الإبلاغ عن خطأ، ابحث في فئة الأخطاء على Meta عن مشكلات مماثلة للتأكد من أنه لم يتم الإبلاغ عنه بالفعل. يساعد ذلك في تجنب التقارير المكررة ويوفر رؤى حول ما إذا كان الخطأ قد تم الاعتراف به أو إصلاحه.
التحقق من المشكلة
لتأكيد أن مشكلتك هي خطأ قابل للتكرار وليس محددًا بإعدادك:
- اختبر على try.discourse.org: استخدم بيئة الاختبار الافتراضية على try.discourse.org لمعرفة ما إذا كان يمكنك تكرار المشكلة.
- استخدم قناة
latest: إذا كنت تختبر على مثيل Discourse الخاص بك، تأكد من استخدام فرعlatest
خطوات متقدمة (اختياري)
- إرسال طلب سحب (Pull Request): إذا كنت قادرًا، أرسل طلب سحب مع اختبار فاشل يوضح الخطأ.
- إصلاح الخطأ بنفسك: إذا كنت تفضل معالجة المشكلة بنفسك، اتبع الإرشادات على Contributing to Discourse development.
إنشاء تقرير خطأ مفصل
أخيرًا، إذا استمرت المشكلة وتأكدت منها في بيئة الاختبار:
- افتح موضوعًا في فئة الأخطاء: انتقل إلى فئة الأخطاء على Meta وأنشئ موضوعًا جديدًا.
- تضمين خطوات قابلة للتكرار: اذكر كل ما تعرفه عن الخطأ، بما في ذلك خطوات إعادة إنتاجه. ارجع إلى دليل كيفية كتابة تقرير خطأ جيد للحصول على نصائح حول المعلومات التي يجب تضمينها.
بمجرد إصلاح الخطأ، يمكنك عمومًا توقع أن يتم نشر التحديثات في موضوع الإبلاغ.