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

قبل أن تبدأ

قبل البدء في المساهمة، يمكن أن يساعدك ذلك في التعرف على المشروع ككل. إذا لم تكن قد انتهيت بالفعل من [BeeWare التعليمي] (https://docs.beeware.org)، فابدأ من هناك. سيعطيك هذا التعرض لأهم أدوات BeeWare، حتى تتمكن من رؤية كيف تتوافق جميعها معًا.

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

ومع ذلك، إذا كانت تجربتك التعليمية سلسة تمامًا (ونأمل أن تكون أن تكون كذلك!)، فإليك بعض الأفكار حول كيفية المشاركة، اعتمادًا على مهاراتك واهتماماتك.

برمجة بايثون

حقيبة ### حقيبة

إذا كنت ترغب في المساهمة في أداة لديها مشكلة واضحة المعالم، ولكن تحتاج إلى معالجة الأخطاء وإضافة ميزات واضحة المعالم، ولكنها تحتاج إلى سحق الأخطاء وإضافة ميزات, قد يكون مشروع [الحقيبة] (https://github.com/beeware/briefcase) هو المشروع المناسب لك. لك. الحقيبة الموجزة هي أداة لتغليف مشروع بايثون كتطبيق مستقل تطبيق واجهة مستخدم رسومية مستقل. يأخذ ملف تكوين 'pyproject.toml'، ويستخدم بيانات التكوين تلك يستخدم بيانات التكوين تلك لتوليد أدوات التثبيت أو حزم التطبيقات القابلة للتوزيع حزم التطبيقات القابلة للتوزيع.

الحقيبة [العدد تعقب] (https://github.com/beeware/briefcase/issues) تحتوي على مجموعة من اقتراحات الميزات (وعدد أقل من الأخطاء). إذا كانت هذه هي المرة الأولى التي تساهم فيها، فابحث عن إحدى التذاكر التي تحمل اسم [جيد الأولى issue] (https://github.com/beeware/briefcase/issues?q=is%3Aopen+هو https://github.com/beeware/briefcase/issues?q=is%3Aopen+هو%3Aissue+التسمية%3A%22%22good%20first%20issue%22) - هذه هي المشكلات التي تم اختيارها خصيصًا للمساهمين لأول مرة للمساهمين لأول مرة لأنها يجب أن تكون سهلة التنفيذ نسبيًا تنفيذها. قد تجد أيضًا أنه من المفيد تصفية التذاكر ل النظام الأساسي الذي تستخدمه بالفعل للتطوير - سيكون من الصعب إصلاح خطأ في نظام لينكس إذا لم يكن لديك جهاز لينكس لاستخدامه في الاختبار!

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

اختر تذكرة، واترك تعليقًا بأنك تبحث في المشكلة، و حاول تطوير طلب سحب لتنفيذ الإصلاح!

برمجة واجهة المستخدم الرسومية

إذا كانت لديك خبرة في استخدام مكتبة عناصر واجهة مستخدم أصلية - كاكاو على نظام ماك, GTK+ على لينكس أو نماذج ويندوز أو مكتبات iOS أو أندرويد الأصلية, فقد تتمكن من المساعدة في استخدام [Toga] (https://github.com/beeware/toga). Toga عبارة عن مجموعة أدوات متعددة المنصات - توفر واجهة مشتركة لعناصر واجهة المستخدم مثل الأزرار والأشجار.

يحتوي Toga على مجموعة من الواجهات المحددة بالفعل؛ ومع ذلك، فإن لم يكتمل تنفيذ تلك الواجهات عبر جميع المنصات. اختر واجهة، وقم بتنفيذ تلك الواجهة للمنصة التي تختارها!

حتى لو لم تكن تعرف مكتبة عناصر واجهة مستخدم أصلية، قد تظل قادرًا على المساعدة مع توغا. كتابة أدوات جديدة أقل تعقيدًا بكثير مما قد يبدو مما قد يبدو. كل منصة لديها وثائق حول كيفية استخدام واجهات برمجة التطبيقات، وعملية ترجمة وثائق تلك المنصة من لغة لغة أخرى (على سبيل المثال، Objective C أو C#) هي عملية عملية بسيطة نسبيًا. يجب أن تعطيك الشيفرة الحالية بعض المؤشرات لكيفية القيام بذلك، ويسعد فريق BeeWare بمساعدتك إذا كنت إذا احتجت إليها. انتقل إلى [BeeWare Discord] (/bee/chat/) وسنفعل كل ما نستطيع مساعدتك!

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

التوثيق

التوثيق الجيد ضروري لأي مشروع ناجح. نحن نعلم أن توجا و Briefcase كلاهما يحتاج إلى تحسينات كبيرة على وثائقهما. لقد انتهيت من البرنامج التعليمي؛ والآن ألقِ ألق نظرة على وثائق Toga و و [الحقيبة] (https://briefcase.readthedocs.io) ومعرفة ما إذا كان بإمكانك العثور على طريقة لتحسين البرامج التعليمية والمراجع وأدلة الموضوعات الموجودة هناك.

دروس تعليمية

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

أثناء عملك من خلال البرنامج التعليمي، لاحظ أي شيء غير غير منطقي أو لا يعمل. ثم افتح تقريراً عن تلك المشاكل.

ويندوز

إذا كنت من مستخدمي Windows، يمكن لـ BeeWare بالتأكيد الاستفادة من مساعدتك. الفريق الأساسي يستخدم الفريق الأساسي جميعًا نظامي Linux و macOS في تطويرهم اليومي، ونتيجة لذلك ونتيجة لذلك، من السهل حقًا أن يتسلل عدم التوافق مع ويندوز. وهذا دائمًا بسبب سهوٍ ما. تحديد - وربما حتى يعد إصلاح مشاكل تشغيل أدوات BeeWare على نظام ويندوز أمرًا مفيدًا للغاية مساعدة كبيرة.

اللغات

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

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

الاستخدام العملي

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

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