كتابة توثيق واضح ومنظم من أهم المهارات التي يمكن لمهندس ضمان الجودة امتلاكها. التوثيق الجيد يوفر ساعات من التواصل ويقلل سوء الفهم ويبني الثقة مع فريقك.
[أين] — [ماذا يحدث] [متى / تحت أي شرط]
| عنوان سيء |
عنوان جيد |
| "خطأ في تسجيل الدخول" |
"صفحة تسجيل الدخول — لا تظهر رسالة خطأ عندما كلمة المرور فارغة" |
| "الدفع معطل" |
"صفحة الدفع — المجموع يظهر 0$ بعد تطبيق خصم 100%" |
| "البحث لا يعمل" |
"نتائج البحث — تُرجع 0 نتائج لاستعلامات بأحرف خاصة" |
| القاعدة |
المثال |
| رقم كل خطوة |
1. انتقل إلى... 2. اضغط على... |
| كن محدداً بالمدخلات |
أدخل "test@example.com" (ليس "أدخل بريداً") |
| تضمين نقطة البداية |
"1. افتح التطبيق وسجل دخول كمشرف" |
| إجراء واحد لكل خطوة |
افصل "اضغط إرسال" عن "لاحظ النتيجة" |
| لغة غامضة |
لغة دقيقة |
| "الصفحة بطيئة" |
"الصفحة تستغرق 12 ثانية للتحميل (المتوقع: أقل من 3 ثواني)" |
| "تظهر خطأ" |
"رسالة خطأ: 'Internal Server Error 500'" |
| "أحياناً لا تعمل" |
"تفشل في 3 من 5 محاولات بنفس المدخلات" |
| القسم |
ما يجب تضمينه |
| Objective (الهدف) |
ما تهدف خطة الاختبار لتحقيقه |
| Scope (النطاق) |
ما سيُختبر وما لن يُختبر |
| Entry Criteria (معايير الدخول) |
شروط بدء الاختبار |
| Exit Criteria (معايير الخروج) |
شروط اكتمال الاختبار |
| Resources (الموارد) |
الفريق والأدوات والبيئات |
| Schedule (الجدول) |
الجدول الزمني مع المعالم |
| Risks (المخاطر) |
ما يمكن أن يحدث خطأ |
| العنصر |
الوصف |
| الشروط المسبقة |
ما يجب أن يكون صحيحاً قبل البدء |
| الخطوات |
إجراءات مرقمة ومحددة |
| النتائج المتوقعة |
ما يجب أن يحدث بالتحديد |
| الشروط اللاحقة |
حالة النظام بعد الاختبار |
| نصيحة |
مثال سيء |
مثال جيد |
| كن محدداً |
"أدخل بريداً صالحاً" |
"أدخل: test@example.com" |
| صف النتيجة بدقة |
"الصفحة تعمل" |
"لوحة التحكم تحمل خلال 3 ثواني" |
| اختبر الحدود |
"أدخل رقماً" |
"أدخل: 0 (أقل من الحد)، 1 (الحد الأدنى)، 99 (الحد الأقصى)" |
TEST SUMMARY REPORT — ملخص تقرير الاختبار
Total: 420 | Executed: 415 | Passed: 398 (95.9%) | Failed: 12
التوصية: GO — جميع معايير الخروج مستوفاة
| القرار |
متى يُستخدم |
| GO (إصدار) |
جميع المعايير مستوفاة، لا عوائق |
| CONDITIONAL GO (إصدار مشروط) |
المعايير مستوفاة غالباً، مشاكل ثانوية مع جدول إصلاح |
| NO-GO (لا إصدار) |
مشاكل حرجة تمنع الإصدار |
"All exit criteria are met. I recommend we proceed."
جميع معايير الخروج مستوفاة. أوصي بالمتابعة
"I cannot recommend this release. We have critical bugs."
لا أستطيع التوصية بهذا الإصدار. لدينا أخطاء حرجة
تهانينا على إكمال دورة الإنجليزية لمهندسي ضمان الجودة. أجب على الاختبار لاختبار معرفتك وكسب رصيدك.
:::
