هذا الموضوع هو الموضوع الرابع والأخير في سلسلة المواضيع عن الإبلاغ الفعّال عن الأخطاء. كان الحديث في الموضوع الثالث عن بعض النقاط التي يجب مراعاتها للحفاظ على تنظيم الأمور أثناء الإبلاغ عن الأخطاء. في هذا الموضوع نُكمِل الحديث عن عملية إنشاء تقرير الخطأ والحقول والتفاصيل الأساسية في تقرير الخطأ.

كما ذكرنا في الموضوع السابق، قد تبدو عملية إنشاء تقرير الخطأ كمعلومات كثيرة يجب معالجتها ولكن بمجرّد الإبلاغ عن الخطأ الأول سيصبح الأمر أسهل في كل مرة. هنا تفاصيل أكثر عن عملية إنشاء تقرير الخطأ.

وجود منصّات مختلفة للإبلاغ عن الأخطاء

هناك العديد من المنصّات التي يمكن أن يستخدمها المشروع مثل JIRA و Visual Studio. تحتوي هذه المنصّات على جميع المعلومات حول المشروع مثل الأخطاء السابقة المُبلّغ عنها وإصلاحات الأخطاء والإصدارات المُخطّط لها وغيرها من المعلومات المهمّة. القسم الذي يجب أن تهتم به في هذه المرحلة هو قسم الأخطاء المُبلّغ عنها من قبل. هذا هو المكان الذي ستجد فيه جميع الأخطاء التي تم الإبلاغ عنها مسبقًا والمكان الذي ستضيف فيه الأخطاء الخاصة بك أيضًا. لإضافة الخطأ الخاص بك ، انقر فوق الزر إنشاء/Create أو +. سينتج عن هذا عادة نافذة منبثقة لتظهر مع حقول فارغة لكي تملأها بمعلومات عن الخطأ.

هيكل تقرير الخطأ (Structure)

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

• العنوان

فكرة العنوان هي وصْف الخطأ في بضع كلمات. يجب أن يكون العنوان بسيطًا ومفهومًا. يمكن الاستفادة من الأسئلة: ماذا وأين ومتى؟ إذا كان بإمكانك الإجابة على هذه الأسئلة الثلاثة بأكبر قدر ممكن، فستحصل على أفضل عنوان للخطأ. في المثال التالي نلاحظ أننا قادرون على الإجابة عن هذه الأسئلة السابقة (ماذا وأين ومتى):

Close button not working on homepage when clicked.

بالإضافة إلى ذلك، من المفيد إضافة بعض العلامات أو التصنيفات أمام العنوان مثل لأجهزة أندرويد فقط (for Android devices only).

• الوصف

هذا هو الجزء الذي ستقوم بإدراج معظم البيانات التي جمعتها فيه. هنا يمكنك شرح المشكلة بمزيد من التفصيل. لنلْقِ نظرة على ترتيب كيفية وصف الأشياء وقد تحدّثنا عن تفصيل أغلبها في الموضوع الثاني من هذه السلسلة من المواضيع:

قابلية إعادة الإنتاج – الشروط المسبقة – خطوات إعادة إنتاج الخطأ – النتائج المتوقعة – النتائج الفعليّة – إصدارات البرامج والأجهزة – الملاحظات

• المرفقات

بمجرد كتابة كل شيء، فإن الخطوة الأخيرة هي إضافة بعض الأدلة المرئية. بشكل عام في النافذة المنبثقة لإنشاء تقرير الخطأ، سيكون هناك قسم يمكنك من خلاله تحميل مقاطع الفيديو ولقطات الشاشة والسجلّات. ما عليك سوى اختيار إرفاق وتحميل ملفاتك وحفظها.

متابعة الأخطاء المُبلّغ عنها

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

• إضافة التعليقات (Comments)

بعد إنشاء تقرير خطأ، سيتم تعيين مطوّر للنظر فيه. إذا كان هناك شيء غير واضح أو كانت هناك حاجة إلى مزيد من المعلومات، فسيتم إضافة تعليق أسفل تقرير الخطأ. عملك بسيط في هذه المرحلة – فقط أجب على السؤال وقدّم الإيضاحات المطلوبة.

• إعادة اختبار البرنامج

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

ضع مهاراتك في الإبلاغ عن الأخطاء على المِحَك

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

أهم شيء يجب تذكّره عند إنشاء تقرير خطأ هو أنك لستَ وحدك. يجب على الجميع البدْء من مكانٍ ما، لذلك لا تخفْ من سؤال زملائك أو قادة المشروع أو حتى استخدام Google للعثور على إجابة لسؤالك. استفد واستخدم هذه السلسلة من المواضيع وضع مهاراتك في الإبلاغ عن الأخطاء على المِحَك.

بالتوفيق للجميع…

* المصدر: https://www.methodsandtools.com/archive/bugreport.php

** الصورة من موقع: https://www.testdevlab.com