انتقل إلى المحتوى

دليل المساهمة¶

هناك العديد من الطرق للمساهمة في BeeWare. تغطي هذه الأدلة كل ما تحتاج إلى معرفته لتقديم مساهمتك.

ماذا يمكنني أن أفعل؟¶

إصلاح مشكلة ¶

أكثر مساهمة واضحة يمكنك تقديمها هي كتابة كود لإصلاح مشكلة معروفة.

تنفيذ ميزة جديدة ¶

هل تفتقد BeeWare ميزة تود رؤيتها؟ يمكنك تنفيذ ميزة جديدة.

كتابة الوثائق ¶

لا تكتمل أي ميزة حتى يتم توثيقها جيدًا. كتابة الوثائق هي طريقة للمساهمة لا تتطلب كتابة كود.

تصنيف مشكلة ¶

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

مراجعة طلب سحب ¶

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

اقترح ميزة جديدة ¶

هل لديك اقتراح أو فكرة لإضافة جديدة إلى إحدى أدوات BeeWare؟ يمكنك اقتراح ميزة جديدة للنظر فيها.

ترجمة المحتوى ¶

تحتفظ BeeWare بوثائق متنوعة بعدة لغات. إذا كنت تعرف لغة أخرى غير الإنجليزية، يمكنك المساعدة في ترجمة المحتوى.

استخدم الأدوات ¶

هل لديك فكرة لتطبيق تم إنشاؤه باستخدام Toga؟ هل لديك تطبيق حالي يمكن تجميعه مع Briefcase؟ يمكنك استخدام الأدوات وتقديم ملاحظاتك حول تجربتك.

كيف يمكنني المساهمة؟¶

إعداد بيئة التطوير ¶

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

إعادة إنتاج مشكلة ¶

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

العمل من فرع ¶

عند الاستعداد لتقديم مساهمة، اعمل دائمًا من فرع.

تجنب توسع نطاق العمل ¶

من المهم الحفاظ على التركيز وتجنب تجاوز النطاق في مساهمتك.

اقتراح ميزة جديدة ¶

ستتبع هذه الخطوات لـ اقتراح ميزة جديدة.

كتابة وتشغيل واختبار الكود ¶

لتحديث أو المساهمة في الكود، ستحتاج إلى كتابة الكود وتشغيله واختباره.

بناء الوثائق ¶

لتحديث الوثائق أو المساهمة فيها، يجب أن تكون قادرًا على إنشاء الوثائق.

كتابة الوثائق ¶

للمساهمة في التوثيق، ستقوم بكتابة محتوى جديد أو تحديث المحتوى الموجود.

أضف ملاحظة تغيير ¶

يجب أن يكون كل طلب سحب مصحوبًا بـ ملاحظة التغيير.

إرسال طلب سحب ¶

بمجرد أن تصبح التغييرات جاهزة، ستقوم بإرسال طلب سحب للمراجعة.

قدم تقييمًا ¶

إذا كنت تشعر بالراحة، يمكنك تقديم مراجعة لمساهمة شخص آخر.

ترجمة المحتوى ¶

تستخدم BeeWare Weblate للترجمة، الأمر الذي يتطلب بضع خطوات للبدء.

إرسال مشكلة جديدة ¶

إذا واجهت مشكلة أو خطأ جديدًا، فمن المفيد إرسال مشكلة.

ماذا سيحدث بعد ذلك؟¶

مراجعة طلب السحب ¶

عندما يتم تقديم طلب سحب، فإن الخطوة التالية هي مراجعة طلب السحب.

عملية الإصدار ¶

ستخضع المساهمات المدمجة لعملية الإصدار.

أدلة الأسلوب¶

دليل أسلوب الكود ¶

هذه هي الإرشادات الخاصة بالمساهمة بالكود في مشاريع BeeWare.

دليل أسلوب التوثيق ¶

هذه هي الإرشادات الخاصة بالمساهمة في توثيق مشاريع BeeWare.