مرحبًا بك في سباقات بي وير السريعة!
أهلاً بك! نحن متحمسون للغاية لأنك قررت الانضمام إلينا! إذا لم تكن قد تقدم نفسك بالفعل إلى أحد أعضاء فريق النحل، فيرجى القيام بذلك. بمجرد أن بعد أن تنتهي من ذلك، عُد إلى هنا لتبدأ.
ما هو العدو السريع؟
السباق السريع هو فرصة غير منظمة لقضاء بضع ساعات أو أيام قليلة العمل بشكل تعاوني على مشروع مفتوح المصدر. وغالبا ما تكون مرتبطة ب بمؤتمر؛ فالسباق السريع بعد المؤتمر يوفر فرصة ل لتحويل الطاقة والحماس والاهتمام الذي ولّده المؤتمر إلى تحسينات في البرمجيات التي نستخدمها بشكل يومي.
تعد سباقات السرعة أيضًا فرصة لتعريف الأشخاص بعملية المساهمة في المشروع. أملنا هو أن تستمتع كثيراً بالمساهمة خلال السباقات السريعة لدرجة أنك ستعود إلى المنزل وتواصل المساهمة!
[لا يهم مقدار الخبرة التي لديك لديك] (/المساهمة/المشاركة/المرة الأولى/متلازمة الدعاية/). في سباقات السرعة السابقة, لقد قمنا بدمج مساهمات من أشخاص من جميع مستويات الخبرة - طلاب المدارس الثانوية، وخريجي المعسكر التدريبي حديثي التخرج، والأشخاص الذين لا يعتبرون أنفسهم مبرمجين، ومطورين متمرسين. بغض النظر عن مستوى خبرتك - يمكننا أن نجد لك طريقة للمساهمة.
البرمجة ليست الطريقة الوحيدة التي يمكنك المساهمة بها أيضاً. مشروع مثل BeeWare هو أكثر بكثير من مجرد كود - نحتاج إلى أشخاص لكتابة وتدقيق الوثائق وترجمتها؛ نحن بحاجة إلى أشخاص لتحسين تصميم صفحات الويب؛ حتى عملية مراجعة الأخطاء التي تم التي تم الإبلاغ عنها منذ سنوات وتحديد ما تم إصلاحه على طول الطريق هي مساهمة قيّمة.
الأسئلة الأولية
لكي نبدأ، سنطرح عليك بعض الأسئلة حتى نتمكن من قياس اهتماماتك وخبراتك. سيساعدنا هذا في العثور على أفضل طريقة لمساهمتك. اعمل من خلال الأسئلة، ودوّن ملاحظاتك، ثم ابحث عن أحد أعضاء فريق النحل وشاركنا إجاباتك. إذا لم تفهم السؤال المطروح - لا تقلق بشأن ذلك! أخبرنا بما تعرفه ما تعرفه، وسنعمل معًا لحلها من هناك.
هل استخدمت برنامج BeeWare من قبل؟
إذا لم تقم بذلك، فابدأ بالعمل من خلال [البرنامج التعليمي لـ [BeeWare البرنامج التعليمي] (https://docs.beeware.org/en/latest/). سوف يعطيك مقدمة عن ماهية مشروع BeeWare، وكيف تتلاءم أجزاء المشروع المشروع معًا. إذا واجهتك أي مشاكل أثناء القيام بالبرنامج التعليمي البرنامج التعليمي، فقم بتدوين الملاحظات - لأن ضمان عدم وجود أي شخص آخر لديه نفس المشكلة نفسها هو موضوع رائع للمساهمة الأولى!
بمجرد الانتهاء من البرنامج التعليمي حتى الخطوة 4 على الأقل، انتقل إلى السؤال التالي.
ما هي المعدات الحاسوبية التي بحوزتك؟
تضع المعدات التي معك حدودًا عملية لما يمكنك يمكنك المساهمة فيه. على سبيل المثال، إذا كان لديك جهاز كمبيوتر محمول يعمل بنظام ويندوز، فأنت لن تكون قادرًا على العمل على أي شيء يتعلق بنظام iOS. هل يعمل حاسوبك المحمول حاسوبك المحمول يعمل بنظام ويندوز أو ماك أو لينكس أو أي شيء آخر؟ هل هاتفك جهاز يعمل بنظام iOS أو Android؟ هل تم توفير أجهزتك من قبل من صاحب العمل، أم أنها أجهزتك الشخصية؟
ما مدى خبرتك في كتابة كود بايثون؟
هل أنت جديد في البرمجة؟ مخضرم في لغة بايثون؟ مخضرم في البرمجة بدأ للتو في تعلم بايثون؟ خريج جديد من برنامج تدريبي؟ نحن نريد أن نجد مشكلة تتناسب مع لمستوى خبرتك.
هل أنت على دراية بعمليات المساهمة في موقع Github؟
هل تستخدم GitHub (أو أي موقع مشابه لمشاركة الأكواد البرمجية) لاستضافة أو المساهمة في مشاريع الآخرين؟ هل تعرف ما هو التكامل المستمر (التكامل المستمر)؟ هل ساهمت في مشروع لديه خطافات ما قبل الالتزام؟ إذا طلبتُ منك "إعادة تأسيس PR الخاص بك مقابل الرئيسي"، هل تعرف ماذا تفعل؟
هل ساهمت في مشروع مفتوح المصدر من قبل؟
هل حضرت سباقاً سريعاً في الماضي؟ هل سبق لك أن أرسلتَ طلبًا للعلاقات العامة (طلب سحب) إلى مشروع مفتوح المصدر؟ هل أنت على دراية بكيفية استخدام Github لإنشاء طلب سحب؟
هل لديك أي مهارات خاصة أخرى قد تكون مفيدة؟
هل أنت على دراية بواجهة برمجة تطبيقات واجهة المستخدم الرسومية (مثل Winforms أو Cocoa أو GTK)؟ هل لديك معرفة عميقة بالأمور الداخلية لنظام تشغيل معين؟ نظام تشغيل معين؟ هل أنت خبير في لغة برمجة أخرى غير بايثون؟ إذا لم تكن لديك أي مهارات خاصة، فهذه ليست مشكلة. ولكن إذا كان لدينا خبير في نظام التشغيل ويندوز بين أيدينا، فنحن نريد أن التأكد من استخدام هذه المهارات بشكل جيد.
لماذا انضممت إلينا وما هي اهتماماتك؟
"بدوت كمشروع ودود" هي إجابة جيدة تماماً. ومع ذلك، إذا كان هناك المزيد عن سبب انضمامك إلينا اليوم، فأخبرنا بذلك. هل أنت مهتم بتطوير الأجهزة المحمولة أم المكتبية؟ التغليف؟ مواقع الويب؟ تطبيقات وحدة التحكم؟ إذا لم يكن لديك اهتمام محدد - ما الذي يبدو الأكثر إثارة للاهتمام بناءً على ما رأيته عن BeeWare حتى الآن حتى الآن؟
والآن، ابحث عن أحد أعضاء فريق النحل لمشاركة إجاباتك. قد يسألون بعض أسئلة المتابعة؛ ولكن بعد ذلك سيوجهونك إلى مجال يمكنك أن تكون قادراً على تقديم مساهمة فيه.
ابحث عن مشكلتك
إذا كنت قد تحدثت إلى أحد أعضاء فريق Bee، فمن المحتمل أن يكونوا قد أشاروا إليك إلى جزء من مشروع BeeWare حيث يمكنك المساهمة فيه؛ وربما اقترحوا عليك مشكلة معينة للعمل عليها. وربما اقترحوا مشكلة معينة للعمل عليها. إذا لم يعطوك أعطوك مشكلة محددة، فربما وجهوك إلى "المشكلات الجيدة المشكلات الأولى" لهذا المشروع. ماذا يعني ذلك؟
يوفر GitHub قائمة بالمشكلات التي تسمح ل BeeWare (وغيرها من وغيرها من المشاريع) بتتبع جميع المشاكل التي تم الإبلاغ عنها - والتي تتضمن التي تتضمن الأخطاء الصريحة، والسلوك غير المتوقع الذي قد يكون خطأ, طلبات للحصول على ميزات جديدة، طلبات لمزيد من التوثيق - أي شيء قد يكون وسيلة يمكن من خلالها تحسين BeeWare. عندما يتم الإبلاغ عن مشكلات جديدة سيقوم فريق Bee Team بالإبلاغ عن بعض منها على أنها مشكلات تناسب المساهمين لأول مرة - المشكلات التي لا تتطلب إصلاحًا فوريًا، لكنها محددة جيدًا أو يسهل إعادة إنتاجها، وربما لديها دليل جيد على السبب الأساسي. يتم وسم هذه المشكلات ب "مشكلة مشكلة أولى جيدة" لتسهيل العثور عليها.
لتصفية قائمة مشكلات GitHub حسب تسمية "المشكلة الأولى الجيدة"، اتبع هذه الخطوات:
- انقر على زر "تسميات" أعلى قائمة المشكلات لتنشيط القائمة المنسدلة.
- اكتب كلمة "جيدة" في مربع البحث أعلى القائمة المنسدلة القائمة المنسدلة.
- انقر على "الإصدار الأول الجيد" في القائمة التي تمت تصفيتها.
<الشكل
بمجرد عثورك على مشكلة تبدو مثيرة للاهتمام، اقرأ أي التعليقات على المنشور، وانشر تعليقًا في المناقشة تقول فيه أنك بأنك تبحث في المشكلة (على سبيل المثال، "أبحث في هذا الأمر في PyCon US 2025"). لا تقوم BeeWare صراحةً ب "تعيين" المشكلات - نحن نقبل المساهمات من أي شخص. ومع ذلك، في حالة العدو السريع، نحتاج إلى التأكد من أننا لا ينتهي بنا الأمر بشخصين يعملان على نفس المشكلة المشكلة - ترك تعليق هو وسيلة خفيفة الوزن للتنسيق بين المساهمين.
إذا كنت لا تزال غير قادر على العثور على أي شيء ترغب في القيام به، فابحث عن أحد أعضاء فريق Bee وسيساعدك في تضييق نطاق البحث إلى مشكلة معينة.
إعداد بيئة التطوير
بمجرد عثورك على مشكلة، ستحتاج إلى إعداد بيئة التطوير الخاصة بك حتى تتمكن من العمل على الإصلاح. كل مشروع من مشاريع BeeWare له دليل مساهمة خاص به:
إذا لم يكن المشروع مدرجًا في هذه القائمة، فتحقق من المشروع README للحصول على التفاصيل حول كيفية الإعداد. إذا كانت أي من التعليمات غير منطقية (أو أو لم تتمكن من العثور على تلك التعليمات)، فابحث عن أحد أعضاء فريق Bee، و وسيقومون بحل المشكلة. وإذا كنت تعتقد أنه يمكنك تحسين التعليمات حتى لا يواجه الأشخاص الآخرون نفس المشكلة، فإن تحسين دليل المساهمة هو مساهمة قيمة!
الآن يمكنك البدء في العمل على مشكلتك!
ماذا يحدث بعد تقديمي للعلاقات العامة؟
بمجرد إرسال طلب السحب الخاص بك، واجتياز طلب السحب جميع الفحوصات الآلية، تصبح جاهزًا للمراجعة. دع أحد أعضاء فريق الأساسية بأن لديك طلب سحب جاهز للمراجعة، وسيقومون بإلقاء نظرة.
إذا كانت هذه أول علاقات عامة لك، فمن المحتمل جداً أن تجد المراجعة بعض المشاكل. قد تكون هذه مشكلة لم تضعها في الحسبان، أو قد تكون شيفرة لم تتبعها. لا تثبط عزيمتك! لا أحد - ولا حتى حتى الفريق الأساسي - يحصل على علاقات عامة صحيحة 100% من المحاولة الأولى.
بمجرد أن تجتاز العلاقات العامة المراجعة، سيقوم المراجع الخاص بك بدمج العلاقات العامة - وتكون قد انتهيت! تهانينا - لقد ساهمت في BeeWare! إذا كانت هذه هي مساهمتك الأولى في BeeWare، فقد ربحت أيضًا [عملة تحدي BeeWare عملة التحدي] (/المساهمة/ عملات التحدي) - ابحث عن أحد أعضاء الفريق الأساسي، وسيعطيك عملة معدنية!
النجدة! أنا عالق!
إذا واجهتك مشكلة في أي نقطة على طول الطريق، ابحث عن أحد أعضاء من فريق النحل. لا تخف من طرح أي سؤال. إذا كنت عالقًا، فنحن نريد أن نخرجك من هذا المأزق. إذا كنت في حيرة من أمرك، فذلك لأن الموضوع معقد، ونحن لم نشرحه بما فيه الكفاية. نحن حريصون على المساعدة - ونريد التأكد من حصولك على سباق سريع ناجح.
What if I don't complete my contribution during the sprint?
No problem! You can submit a contribution at any time. A goal of the sprints is to encourage and empower you to continue contributing throughout the rest of the year. The Bee Team are available to help with any part of this process.
If you were already working on a GitHub issue or submitted a PR, you can continue to communicate through GitHub. If you have other questions or need real-time help, the best place to find us is the BeeWare Discord server. We're looking forward to continuing to work with you!