مدونة نافذة التقنية مدونة نافذة التقنية – موقع يقدّم شروحات تقنية حديثة حول Windows، Android، الذكاء الاصطناعي، وأدوات المطورين بطريقة سهلة وواضحة للمستخدم العربي.
قد ترغب بالإبلاغ عن خطأ تواجهه مع NVDA, أو تريد اقتراح ميزة جديدة, فكيف تفعل ذلك.
توجد عدة طرق لمناقشة أفكارك مع المجتمع من خلال قوائم NVDA البريدية, إلى جانب التواصل مع بريد المؤسسة.
لكن تصحيح أخطاء أو تنفيذ ميزات يتطلب تفاعل مع مجتمع المطورين على GitHub.
ونقدم لكم هنا طريقة الإبلاغ عن مشاكل أو اقتراح أخطاء مباشرة من خلال GitHub.
التجهيز لتقرير الأخطاء:
عليك أولًا التأكد من أن الخطأ هو خطأ عام في NVDA وليس خطأ متعلق بإعدادات أو تخصيصات أو إضافات معينة لديك.
شرحنا ذلك بالتفصيل في سلسلة NVDA سابقًا على نافذة التقنية.
ومع ذلك, اضغط NVDA+Q واختر Restart with add-ons disabled and debug logging enabled وبذلك ستفعل السجل بأعلى مستوى وتعطل الإضافات.
اضغط NVDA+Ctrl+R 3 مرات للعودة إلى الإعدادات الافتراضية, ثم حاول تكرار المشكلة.
تأكد من تعطيل خيار حفظ الإعدادات عند إغلاق البرنامج لتجنب حفظ إعداداتك الافتراضية, ثم ارجع إلى الإعدادات المحفوظة من خلال NVDA+Ctrl+R مرة واحدة.
عند تكرار الخطأ, قد يتم كتابة بيانات في سجل NVDA, الذي يمكنك فتحه عن طريق NVDA+F1.
من هناك, حدد النص وقم بنسخه إلى ملف, او اضغط Alt واختر Save as لحفظ الملف باسم ومسار تحدده.
يتم حفظ سجل nvda في temp باسم nvda.log وبعد إعادة تشغيل NVDA يتم الاحتفاظ بآخر نسخة سابقة من السجل في نفس المسار باسم nvda-old.log.
الإبلاغ عن الأخطاء واقتراح الميزات:
بعد أن أصبح لديك تفاصيل الخطأ وسجل لما حدث أثناء الخطأ, انتقل إلى مستودع NVDA من هنا:
صفحة المستودع.
انتقل إلى Issues ثم New issue.
قبل أن تفعل ذلك, تأكد من البحث في نفس الصفحة من خلال مربع البحث, فربما يوجد شخص آخر أبلغ عن نفس الخطأ.
والآن اختر نوع المشكلة كما يلي.
- Bug report للإبلاغ عن خطأ.
- Feature request لاقتراح أو طلب ميزة.
- Special Case Issue للإبلاغ عن مشكلة خاصة وتختلف عن نمط المشاكل الذي سنكتشفه.
- Developer facing changes إذا كنت مطور لإضافات أو ما شابه ذلك ولديك تغييرات للمطورين تود مناقشتها أو الإبلاغ عنها, مثل تحديثات NVDA التي قد تتسبب بحدوث أخطاء في إضافتك.
- Advanced يحتوي على نفس الخيارات السابقة, لكنه قالب واحد يمكنك الإجابة على الأسئلة فيه ضمن مربع التحرير, وليس مربعات كتابة لكل سؤال كما في النمط الأول للمبتدئين.
- Report a security vulnerability خطوات إرشادية للإبلاغ عن ثغرة أمنية.
نموذج الأسئلة:
إذا اخترت الخيار الأول أو الثاني, ستجد مربعات كتابة تسألك عن المشكلة وتطلب منك كتابة معلومات مثل إصدار NVDA وإصدار Windows وخطوات تكرار الخطأ, إلى جانب النتائج الحالية والنتائج المتوقعة وغير ذلك.
وهذه طريقة مناسبة للمبتدئين حيث يتم إرشادك وشرح كل عنصر مطلوب بالتفصيل.
إذا اخترت الخيارات المتقدمة من الأول والثاني, ستجد مربع كتابة واحد مع نموذج لقالب جاهز يمكنك الإجابة في السطور الفارغة وإرساله, مع أهمية اتباع تنسيق md.
وسنأخذ أمثلة عن القالب, لكن لا تختر الخيارات المتقدمة إذا كنت مبتدئ مع GitHub, بينما ننصح باختيار الخيارات المتقدمة إذا كنت متمكن من الموقع.
اكتب عنوان مختصر يشرح مشكلتك في Title.
ثم اكتب ملخص لمشكلتك في البداية, ضعها تحت أي عنوان مثل Summary
في السطور التالية توجد علامات # لا تحذفها, فهي لتنسيق العناوين, اترك سطر فارغ بين كل عنصر وآخر من العناوين, تمت إزالة علامات # في هذا الشرح:
Steps to reproduce
اكتب خطوات تكرار الخطأ.
Actual behavior
اكتب السلوك الحالي لما يحدث عند تكرار الخطأ.
Expected behavior
اكتب السلوك المتوقع أو الذي تفترض إنه سيحدث بدل الخطأ.
NVDA logs, crash dumps and other attachments
هنا ضع أي ملفات سجل أو بيانات تخص الخطأ, قم بنسخ الملف ولصقه في محرر GitHub وسيتم رفعه وتسمية الرابط باسم الملف.
System configuration
معلومات تتعلق بالنظام ستجيب عليها في السطور التالية.
NVDA installed/portable/running from source
اكتب نوع نسخة NVDA ما إذا كانت مثبتة أو محمولة أو يتم تشغيلها من الكود.
NVDA version
اكتب إصدار NVDA الذي يواجه المشكلة.
Windows version
اكتب إصدار Windows الذي تستخدمه.
Name and version of other software in use when reproducing the issue
اكتب اسم أي برنامج آخر تستخدمه أثناء حدوث الخطأ.
Other information about your system
أي معلومات إضافية تراها مناسبة عن النظام, مثل اللغة وإعدادات محددة قد تكون مرتبطة بالخطأ.
Other questions
أسئلة أخرى ستجيب عليها.
Does the issue still occur after restarting your computer?
لتوضيح ما إذا كانت المشكلة مستمرة بعد إعادة تشغيل الجهاز, اكتب Yes او No.
Have you tried any other versions of NVDA? If so, please report their behaviors
وضح ما إذا جربت إصدارات أخرى من NVDA مع توضيح سلوكهم في التجربة.
If NVDA add-ons are disabled, is your problem still occurring?
أجب عن ما إذا المشكلة مستمرة بعد تعطيل الإضافات.
Does the issue still occur after you run the COM Registration Fixing Tool in NVDA’s tools menu?
أجب ما إذا المشكلة مستمرة بعد تجربة أداة COM Registration Fixing Tool.
ثم أرسل النموذج.
بذلك قمت بفتح Issue على GitHub ويمكنك مراقبة تفاعل المطورين معها والإجابة على أي أسئلة لديهم.
إذا أردت تقديم اقتراح, فهذا شكل القالب المستخدم.
Is your feature request related to a problem? Please describe
وضح ما إذا كانت الميزة التي تقترحها مرتبطة بمشكلة, واشرح ذلك بالتفصيل.
Describe the solution you’d like
اشرح الحل الذي يعجبك وتراه مناسب للمشكلة من خلال ميزة جديدة.
Describe alternatives you’ve considered
اشرح حلول بديلة فكرت بها.
Additional context
سياق إضافي لتضمين معلومات أكثر عن الاقتراح.
وهذا كل ما يتعلق بهذا الأمر.
تذكر استخدام الإنجليزية وعدم حذف علامات # وترك سطور فارغة قبل كل عنوان وبعده كما في هذا الشرح, وتذكر متابعة أي ردود على الIssue التي قمت بفتحها.
وهذا كل شيء.
