How to report a bug/ar

تفسر هذه الإرشادات كيفية كتابة بلاغ جيد عن عطل أو طلب سمة برمجية (مهمة) على متابع مهام ويكيميديا (طالع كي تتعرف على المزيد من المعلومات). يزيد احتمال العمل سريعا على المهام التي صيغت صياغة جيدة.

توصيات سريعة

 * كن دقيقا
 * كن واضحا: وضح كيف يمكن إعادة استعراض المشكلة، خطوة بخطوة، حتى يمكن للآخرين إعادة استعراض العطل الفني أو استيعاب الطلب.
 * قدم مشكلة واحدة فقط في مهمة واحدة
 * أضف أي وصلات شبكية وأمثلة ذات صلة بالأمر
 * Be clear: explain 1) how to reproduce the situation, step by step, without leaving any room for interpretation, 2) expected behavior, 3) actual behavior. In separate sections
 * Include only one problem per task
 * Include any relevant links and examples

هل يمكنك إعادة استعراض المشكلة؟
حاول إعادة استعراض عطلك البرمجي مستخدما نسخة حديثة من البرمجيات، كي ترى هل تم تصويب هذه المشكلة بالفعل أم لا. لو كان العطل الفني على موقع ويكي مثل ويكيبيديا، يمكنك محاولة اختبار أحدث نسخة من البرمجيات على موقع test2.wikipedia.org.

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

لو لم تكن متأكدا ما إذا كان عطلا فنيا أبلغ عنه من قبل، يتعين عليك أن تبلّغ عن العطل الفني. من الأفضل أن توجد بلاغات مكررة عن عطل فني بدلا من ألا توجد بلاغات على الإطلاق.

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

الإبلاغ عن عطل فني جديد أو طلب سمة برمجية
لو رأيت عطل برمجي في إصدار حديث ولم ترى أن أي فرد آخر قد أبلغ عن هذا العطل البرمجي، عليك إذا أن تفعل ما يلي:
 * 1) اذهب إلى  phabricator.wikimedia.org
 * 2) سيتعين عليك أن تسجل الدخول (أو تسجيل حساب مستخدم) لو لم تفعل ذلك من قبل (طالع "").
 * 3) اضغط على زر «علامة مرجعية - Bookmark» الموجود في الركن العلوي الأيمن من الصفحة اختر «إنشاء مهمة – Create Task» (أو «الإبلاغ عن مشكلة أمنية – Report Security issues» كي ).
 * 4) املأ الخانات التالية على الأقل:
 * 5) * العنوان: موجز قصير من جملة واحدة يفسر المشكلة (لا الحل الذي تقترحه لها).
 * 6) ** جيد:
 * 7) ** سيء:
 * 8) * مخصص إلى: عليك أن تتجاهل هذه الخانة: سوف يتولى المطورون تخصيص هذه المهمة إلى شخص ما حينما يعتزمون العمل على هذه المهمة.
 * 9) * بيان: كافة تفاصيل المشكلة حيث تقدم أكبر كم من التفاصيل قدر الإمكان. يجب أن يشتمل ذلك على ما يلي:
 * 10) ** للأعطال:
 * 11) *** خطوات إعادة الاستعراض: خطوات قصيرة يسهل اتباعها سوف ينتج عنها المشكلة المبينة. أضف أية خطوات تنصيب خاصة.
 * مثال:
 * 1) *** النتائج الفعلية: ما فعله التطبيق بعد اتباع الخطوات سالفة الذكر.
 * مثال:
 * 1) *** النتائج المتوقعة: ما هو متوقع من التطبيق تنفيذه، لو لم توجد ثمة أعطال فنية.
 * مثال:
 * 1) ** لطلبات السمات البرمجية:
 * 2) *** بيان بما ترغب في تحقيقه ولماذا. اشرح ما الذي تأمل أن تحله هذه السمة البرمجية (المشكلة الفعلية التي ترغب في حلها) مع أمثلة محددة؛ لا تطلب حلا محددا، لأنه قد توجد حلول أخرى أو حلول أفضل للمشكلة. تقديم قصة مستخدم هو سبيل فعال في توصيل هذه الصورة.
 * مثال:
 * 1) ** يرجى أيضا تقديم أية معلومات أخرى قد تكون ذات فائدة، مثل ما يلي:
 * 2) *** متصفحات الإنترنت أو السمات أو أنظمة الكمبيوتر التي رأيت العطل البرمجي عليها؛
 * 3) *** الوصلات الشبكية أو الاختلافات على صفحة واحدة أو أكثر التي وجدت فيها العطل الفني؛ أو
 * 4) *** هل تظهر المشكلة كل مرة أم بين حين وآخر أم على صفحات بعينها دون غيرها أو في ظروف محددة لا غيرها.
 * 5) * كي ترفق ملف سجل أو (لكن احرص على عدم وجود أو عرض بيانات سرية أو خصوصية فيها)، اضغط على زر رفع ملف – Upload File (صورة سحابة موجود فيها سهم) على شريط الأدوات في خانة بيان - Description.
 * 6) * اختر الوسوم (المشروع/المشاريع) التي وجدت فيها العطل الفني:
 * 7) ** المشاريع هي الوسيلة التي تمكن المطورين من إيجاد المهام التي ينبغي عليهم العمل عليها. كي تحدد المشاريع الصحيحة، استخدم سمة البحث (في الجزء العلوي الأيمن) كي تبحث عن بيان لها.
 * 8) ** قد يكون هذا الأمر على سبيل المثال مشروع لبرمجيات الويكي ذاته أو  لأغراض تغييرات الإعدادات على موقع ويكيميديا (طالع ).
 * 9) * المشتركون: لو كنت تعرف مستخدمين محددين ومهتمين بتلقي إشعارات بهذه المهمة يمكنك إضافتهم هنا. خلاف ذلك، يمكنك تخطي هذه الخانة.
 * 1) *** متصفحات الإنترنت أو السمات أو أنظمة الكمبيوتر التي رأيت العطل البرمجي عليها؛
 * 2) *** الوصلات الشبكية أو الاختلافات على صفحة واحدة أو أكثر التي وجدت فيها العطل الفني؛ أو
 * 3) *** هل تظهر المشكلة كل مرة أم بين حين وآخر أم على صفحات بعينها دون غيرها أو في ظروف محددة لا غيرها.
 * 4) * كي ترفق ملف سجل أو (لكن احرص على عدم وجود أو عرض بيانات سرية أو خصوصية فيها)، اضغط على زر رفع ملف – Upload File (صورة سحابة موجود فيها سهم) على شريط الأدوات في خانة بيان - Description.
 * 5) * اختر الوسوم (المشروع/المشاريع) التي وجدت فيها العطل الفني:
 * 6) ** المشاريع هي الوسيلة التي تمكن المطورين من إيجاد المهام التي ينبغي عليهم العمل عليها. كي تحدد المشاريع الصحيحة، استخدم سمة البحث (في الجزء العلوي الأيمن) كي تبحث عن بيان لها.
 * 7) ** قد يكون هذا الأمر على سبيل المثال مشروع لبرمجيات الويكي ذاته أو  لأغراض تغييرات الإعدادات على موقع ويكيميديا (طالع ).
 * 8) * المشتركون: لو كنت تعرف مستخدمين محددين ومهتمين بتلقي إشعارات بهذه المهمة يمكنك إضافتهم هنا. خلاف ذلك، يمكنك تخطي هذه الخانة.

تحقق من أن بلاغك كامل، ثم اضغط على زر "إنشاء مهمة – Create Task". أصبح بلاغك الآن موجودا في قاعدة البيانات. سوف يسمح هذا الأمر لفرد مهتم بالبلاغ بالنظر في الأمر وربما.

سوف تتغير أولوية العمل على المهمة على يد أحد المطورين لو أنهم يعتزمون العمل على هذه المهمة (طالع تخصيص الأولويات).

هذا كل شيء! شكرا لك على المساعدة في تحسين ميدياويكي ومشاريع ويكيميديا!

الإبلاغ عن خطأ في الجافا سكريبت

 * أنظر أيضا: Help:Locating broken scripts

العديد من الخاصيات، النبيطات، النصوص البرمجية الشخصية، وبعض أجزاء ميدياويكي، تعتمد على جافا سكريبت.

عندما تواجه عطل برمجي قد يكون سببه جافا سكريبت، حاول قدر الإمكان أن تحدد رسائل الخطأ ونسخها إلى البلاغ عن العطل.

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

لو كانت المشكلة في الكود البرمجي في نص برمجي لأحد المستخدمين أو نبيطة، ربما لن يكون فابريكاتور هو المكان المناسب للتعامل مع المشكلة. ربما يمكن لأحد الأفراد إعادة توجيهك إلى صفحة نقاش النص البرمجي (لو كان النص البرمجي المعطوب معلوما).

الإبلاغ عن مشكلة في الاتصال
لو كنت تواجه مشاكل في الوصول إلى أحد مواقع ويكيميديا (اتصال إنترنت بطيء أو خلافه)، يرجى اتباع Reporting a connectivity issue.

الإبلاغ عن مشكلة في تسجيل الدخول
إن كان لديك مشاكل متعلقة بتسجيل الدخول، اذهب من فضلك إلى Manual:How to debug/Login problems.

انظر أيضا

 * كيفية الإبلاغ عن أعطال فنية بفعالية كتبه سيمون تاثام
 * كيف يمكنك حث مجتمع مطوري البرمجيات على حل مشكلتك، كتبه User:MSchottlender-WMF في شهر يوليو/تموز 2017
 * Wikimedia and إتيكيت فابريكاتور
 * إدارة البلاغات عن الأعطال البرمجية/دورة حياة البلاغات عن الأعطال البرمجية
 * كتابة بلاغ جيد عن عطل برمجي أو طلب سمة
 * كيفية كتابة أول بلاغ عن عطل برمجي جيد (مهمل)
 * English Wikipedia: Bug reports and feature requests