الإبلاغ عن المشكلات

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

مشكلات GitHub هي منصتنا لإصدار التذاكر

يجب الإبلاغ عن المشكلات على GitHub باسم [مشكلات GitHub] (https://github.com/tuist/tuist/issues) وليس على Slack أو منصات أخرى. يعد GitHub أفضل لتتبع المشكلات وإدارتها، وهو أقرب إلى قاعدة البرمجة، ويسمح لنا بتتبع تقدم المشكلة. وعلاوة على ذلك، فإنه يشجع على تقديم وصف مطول للمشكلة، مما يجبر المُبلِّغ على التفكير في المشكلة وتوفير المزيد من السياق.

السياق أمر بالغ الأهمية

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

• ماذا كنت تحاول أن تفعل؟
• كيف يبدو الرسم البياني الخاص بك؟
• ما هو إصدار تويست الذي تستخدمه؟
• هل يعيقك هذا؟

نطلب منك أيضًا توفير الحد الأدنى مشروع قابل للتكرار.

مشروع قابل للتكرار

ما هو المشروع القابل للتكرار؟

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

لماذا يجب عليك إنشاء حالة اختبار قابلة للتكرار؟

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

يعد المشروع القابل للتكرار طريقة رائعة لمشاركة بيئة معينة تسبب خطأ ما. مشروعك القابل للتكرار هو أفضل طريقة لمساعدة الأشخاص الذين يرغبون في مساعدتك.

خطوات إنشاء مشروع قابل للتكرار

• إنشاء مستودع git جديد.
• تهيئة مشروع باستخدام tuist init في دليل المستودع.
• أضف التعليمات البرمجية اللازمة لإعادة إنشاء الخطأ الذي رأيته.
• انشر الكود (حساب GitHub الخاص بك هو مكان جيد للقيام بذلك) ثم اربطه عند إنشاء مشكلة.

فوائد المشروعات القابلة للتكرار

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