انتقل إلى المحتوى الرئيسي

الوحدة 4 · الإبلاغ عن الأخطاء

كتابة بلاغ خطأ

أجزاء البلاغ المفيد وكيف تجعل المشكلة قابلة لإعادة الإنتاج.

نحو 10 دقيقة قراءة و15 دقيقة تطبيق (تقديرات)

جارٍ تحميل التقدم…

اقرأ

أهداف التعلّم

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

الشرح

بلاغ الخطأ طلبٌ لوقت شخص آخر. وأفضل البلاغات تتيح للمطوّر إعادة إنتاج المشكلة من المحاولة الأولى دون أن يسأل أي سؤال.

  • العنوان: ما الخطأ وأين — «إجمالي السلة يتجاهل إزالة رمز الخصم»، لا «السلة معطلة».
  • الخطوات: مرقّمة، تبدأ من حالة معروفة، ولكل خطوة إجراء واحد والبيانات المستخدمة بدقة. احذف الخطوات غير الضرورية.
  • النتيجة المتوقعة: ما يجب أن يحدث، ويُفضّل اقتباس المتطلب.
  • النتيجة الفعلية: ما حدث بدلاً من ذلك، بالقيم والرسائل الدقيقة.
  • البيئة: رقم الإصدار، والمتصفح والجهاز، واللغة، ونوع الحساب، وبيئة الاختبار.
  • الأدلة: لقطة شاشة أو تسجيل قصير، وأخطاء وحدة التحكم، وطلب الشبكة الفاشل، وأسطر السجل ذات الصلة. ولا تُدرج أبداً بيانات شخصية لعملاء حقيقيين أو أسراراً.
  • التكرار: دائماً، أو متقطع («٣ من ١٠ محاولات»).

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

مثال: بلاغ ضعيف وآخر قوي

Title: Search doesn't work
It's broken when I search, please fix.
ضعيف: لا خطوات ولا بيانات ولا نتيجة متوقعة.
Title: Search returns no results when the query has a trailing space
Environment: test build 2026.10.3, Chrome 130, English, signed out

Steps
1. Open the catalogue.
2. Type "basket " (with one trailing space) in Search.
Expected: Palm-leaf basket is listed (search ignores
          surrounding spaces — Expected behaviour, Catalogue).
Actual:   "No products match." 0 results.
Frequency: always (5/5). Without the space, 1 result.
Evidence: screenshot attached.
قوي: محدد ومختصر وقابل للتحقق. (توضيحي — فالمتجر التدريبي يتعامل مع المسافات بشكل صحيح.)

أخطاء شائعة

  • عناوين مبهمة وبيانات ناقصة، فيضطر المطوّر إلى التخمين.
  • خلط عدة مشكلات في بلاغ واحد.
  • كتابة رأي («تصميم سيئ») كأنه خطأ.
  • لقطات شاشة تُظهر النتيجة دون المُدخل الذي سببها.

جرّب

تدرّب على ما قرأته للتو. تُفحص الإجابات هنا، ولا يُقيَّم شيء علناً ولا يُحتسب في ساحة الأخطاء.

تمرين

أعد كتابة هذا البلاغ ليتمكن المطوّر من إعادة إنتاجه: «إتمام الطلب لا يسمح لي بالطلب. حاولت مرات كثيرة. أصلحوه فوراً!!» اختلق تفاصيل وهمية معقولة عند الحاجة وحدّد افتراضاتك.

اكتب إجابتك أولاً، ثم قارنها بالحل النموذجي. تبقى في هذه الصفحة فقط ولا تُرسل إلى أي مكان.

راجع

اختبر نفسك — يجب أن تكون الآن قادراً على:

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

تدرّب في مختبر الجودة

مراجع

تابع

عندما تكون مستعداً، ضع علامة الإكمال على الدرس في خطوة «جرّب» ثم انتقل إلى التالي.

يُوسم بأنه مقروء عندما تصل إلى نهاية الدرس.