ساهم

مهتم بجعل الشبح أفضل؟ نرجو قراءة الأقسام أدناه لترى كيف يمكنك المساهمة.

تقارير العلل

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

تحذير: عدم توفير المعلومات المطلوبة في قالب تقرير العلّة سيؤدي إلى إغلاق تقرير العلّة آليًا.

تصنيف العلل

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

ميزات جديدة وتصحيحات علل

أتعرف البرمجة؟ اتّبع هذه الخطوات:

أرسل علة لميزتك أو علتك على متتبّع علل كيدي.
ملاحظة: هذه الخطوة ضرورية للتأكد من أن الميزة الجديدة تلبي أهداف المشروع أو أن العلّة ليست في الحقيقة ميزة. قد ترغب كذلك في التنسيق حول أي مناطق من الشيفرة ستحدثها لتجنّب تعارضات الدمج في حال كان شخص آخر يعمل على نفس منطقة الشيفرة تلك.
بعد مناقشة علتك الجديدة، برمج ميزتك أو تصحيح علتك. نرجو اتّباع دليل أسلوب برمجة أطر كيدي. هام: نرجو إبقاء شيفرتك مركّزة على العلّة الحالية. التغييرات غير المتعلقة بالشيفرة تنتمي إلى علل/طلبات دمج منفصلة لجعل مراجعة الشيفرة والاختبار أسهل.
أرسل طلب سحب مقابل الفرع الرئيسي بتحديثات شيفرتك.
هام: نرجو ضغط تثبيتاتك في git قبل إرسال طلب السحب!
انتظر مراجعة شيفرة وجيزة ومتطوعَين اثنين على الأقل لاختبار ميزتك أو تصحيح علتك.
أجرِ تحديثات على طلب سحبك عندما تحصل على تعقيب.
عندما يوافق على طلب سحبك متطوعان اثنان على الأقل، سيدمج طلب سحبك.

مراجعات الشيفرة

أتعرف البرمجة ولديك عين للتفاصيل؟ تطوع لمراجعة الأقران لطلبات الدمج الجديدة!

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

هذه بعض التلميحات لما تبحث عنه في مراجعات الشيفرة:

هل تتّبع الشيفرة المُرسلة دليل أسلوب برمجة أطر كيدي؟
هل الشيفرة مقروءة، مع تعليقات تشرح أيّ أسطر غير واضحة؟
هل الشيفرة «متشائمة»؟ بعبارة أخرى، هل تتحقق من القيم غير الصالحة قبل استعمالها وتتعامل مع شروط الخطأ المحتملة؟
هل المقارنات أو العبارات المتعددة مغلفة بين قوسين ضمن عبارات if لمنع حوادث تسلسل العمليات؟ أمثلة:
```
// خاطئ
if (a == b || c > d);

// صحيح
if ((a == b) || (c > d));
```

هل الحروف موجودة على الجانب الأيسر من العامل == لمنع خطأ إملائي مع العامل = من الهروب من ملاحظة المصرّف؟ أمثلة:

// خاطئ
if (variable == 1);

//         السبب: ماذا لو خطأ إملائي؟ المصرّف لن يمسكه!
if (variable = 1); // يا إلهي!
// صحيح
if (1 == variable);

//         السبب: هذه المرة سيمسك المصرّف الخطأ الإملائي.
if (1 = variable); // يا إلهي!

الاختبار

تطوّع لمراجعة الشيفرة واختبار الميزات الجديدة وتصحيحات العلل! اتّبع هذه الخطوات:

ابحث عن طلب دمج جديد، وأضف تعليقًا بأنك تتطوع لاختباره.
ابنِ طلب الدمج على منصتك.
اختبر الميزة/تصحيح العلّة وحاول كسره!
وفّر تعقيبًا على نتائج الاختبار في طلب الدمج.
انتظر تحديثات لطلب الدمج (إن لزم).
واصل الاختبار وتوفير التعقيب حتى تكون واثقًا من عمل الشيفرة.
اترك تعليقًا بموافقتك على طلب الدمج.
عندما يرسل متطوع واحد على الأقل موافقته، سيقبل طلب الدمج.

التّرجمات

نرجو التفكير في الانضمام إلى فريق ترجمات كيدي لترجمة تطبيقاتك المفضلة إلى لغات أخرى.

الدعم التقني

هل لديك معرفة بلينكس أو البناء لماك أو إس؟ أتعرف كيف تصلح تلك المشكلة التي يواجهها الآخرون باستمرار؟ إجابتك على أسئلة المستخدمين واستكشاف الأخطاء وإصلاحها في متتبّع علل كيدي نقدّرها كثيرًا!