توثيقنصائح متنوعة
تجنب تقديم تقارير الأخطاء المكررة في عالم البرمجيات الحرة، جميع أدوات تتبع الأخطاء متاحة للعامة. يمكن تصفح القضايا المفتوحة كما أنها تحتوي على ميزة البحث. وبالتالي، قبل تقديم تقرير خطأ جديد، حاول تحديد ما إذا كان شخص آخر قد أبلغ عن مشكلتك بالفعل.
إذا عثرت على تقرير خطأ موجود، فاشترك فيه وربما أضف معلومات تكميلية. لا تنشر تعليقات مثل "أنا أيضًا" أو "+1"؛ أنها لا تخدم أي غرض. ولكن يمكنك الإشارة إلى أنك متاح لمزيد من الاختبارات إذا لم يقدم المرسل الأصلي ذلك.
إذا لم تجد أي تقرير عن مشكلتك، قم بتقديمه. إذا وجدت التذاكر ذات الصلة، تأكد من ذكرها.
التأكد من استخدام أحدث إصدار: إنه أمر محبط للغاية بالنسبة للمطورين أن يتلقوا تقارير الأخطاء الخاصة بالمشكلات التي قاموا بحلها بالفعل أو المشكلات التي لا يمكنهم إعادة إنتاجها باستخدام الإصدار الذي يستخدمونه (يستخدم المطورون دائمًا الإصدار الأحدث من منتجهم) . حتى عندما يحتفظ المطورون بالإصدارات القديمة، غالبًا ما يقتصر الدعم على الإصلاحات الأمنية والمشكلات الرئيسية. هل أنت متأكد من أن الخطأ الخاص بك هو واحد من هؤلاء؟
ولهذا السبب، قبل تقديم تقرير بالأخطاء، يجب عليك التأكد من أنك تستخدم أحدث إصدار من النظام والتطبيق الذي به مشكلات وأنه يمكنك إعادة إنتاج المشكلة في هذا الموقف.
إذا لم يقدم Kali Linux أحدث إصدار من التطبيق (لا في kali-rolling ولا في kali-bleeding-edge، راجع القسم 8.1.3.3، "مستودع Kali-Bleeding-Edge"[صفحة 174])، لديك حلول بديلة: يمكنك تجربة التثبيت اليدوي لأحدث إصدار في جهاز ظاهري مهمل، أو يمكنك مراجعة سجل التغيير الأولي (أو سجل التزام Git) لمعرفة أنه لم يتم لم يكن هناك أي تغيير يمكن أن يحل المشكلة التي تراها (ثم قم بإبلاغ الخطأ على الرغم من أنك لم تجرب الإصدار الأحدث).
لا تخلط مشكلات متعددة في تقرير خطأ واحد، قم بتقديم تقرير خطأ واحد لكل مشكلة. وبهذه الطريقة، لن تصبح المناقشات اللاحقة فوضوية للغاية ويمكن إصلاح كل خطأ وفقًا لجدوله الزمني الخاص. إذا لم تفعل ذلك، فإما أن الخطأ الفردي يحتاج إلى إعادة استخدامه عدة مرات ولا يمكن إغلاقه إلا عندما يتم إصلاح جميع المشكلات، أو يجب على المطورين تقديم التقارير التكميلية التي كان يجب عليك إنشاؤها في المقام الأول.