تقرير الخطأ

وصف مكتوب لمشكلة في البرنامج يكفي ليعيد أي شخص إظهارها ويصلحها: الخطوات، والمتوقع، وما حدث فعلاً، مع دليل.

تقرير الخطأ الجيد يجيب عن خمسة أسئلة: ما المشكلة في جملة واحدة؟ ما الخطوات التي تُظهرها بالترتيب؟ ماذا كان يُفترض أن يحدث؟ ماذا حدث فعلاً؟ وعلى أي جهاز ومتصفح؟ ويُرفق به دليل مثل لقطة شاشة، وتُحدَّد درجة الخطورة: هل يمنع البيع أم هو عيب شكلي؟

عبارة «الموقع خربان» لا يمكن إصلاحها، أما «زر الدفع لا يستجيب على الجوال بعد اختيار التوصيل» فتُصلَح في دقائق. جودة التقرير تحدد سرعة الإصلاح، سواء كان المصلح مبرمجاً أم وكيل ذكاء اصطناعي. تقارير مهندس الجودة من فنّان تأتي بالصور ودرجة الخطورة، وتجد قالباً جاهزاً في دليل كتابة تقرير الخطأ. نصيحة عملية: اكتب خطأ واحداً في كل تقرير، وجرّب الخطوات مرة ثانية قبل الإرسال لتتأكد أنها تُظهر المشكلة فعلاً.