دليل السباق¶
مرحبًا بكم في BeeWare Sprints!¶
أهلاً بك! نحن متحمسون للغاية لأنك قررت الانضمام إلينا! إذا لم تكن قد تقدم نفسك بالفعل إلى أحد أعضاء فريق النحل، فيرجى القيام بذلك. بمجرد أن بعد أن تنتهي من ذلك، عُد إلى هنا لتبدأ.
ما هو السباق السريع؟¶
السباق السريع هو فرصة غير منظمة لقضاء بضع ساعات أو أيام قليلة العمل بشكل تعاوني على مشروع مفتوح المصدر. وغالبا ما تكون مرتبطة ب بمؤتمر؛ فالسباق السريع بعد المؤتمر يوفر فرصة ل لتحويل الطاقة والحماس والاهتمام الذي ولّده المؤتمر إلى تحسينات في البرمجيات التي نستخدمها بشكل يومي.
تعد سباقات السرعة أيضًا فرصة لتعريف الأشخاص بعملية المساهمة في المشروع. أملنا هو أن تستمتع كثيراً بالمساهمة خلال السباقات السريعة لدرجة أنك ستعود إلى المنزل وتواصل المساهمة!
لا يهم مدى خبرتك. في السباقات السابقة، قمنا بدمج مساهمات أشخاص من جميع مستويات الخبرة - طلاب المدارس الثانوية، خريجي برامج التدريب المكثف، أشخاص لا يعتبرون أنفسهم مبرمجين، ومطورين متمرسين. بغض النظر عن مستوى خبرتك - يمكننا إيجاد طريقة لتساهم بها.
البرمجة ليست الطريقة الوحيدة التي يمكنك المساهمة بها أيضاً. مشروع مثل BeeWare هو أكثر بكثير من مجرد كود - نحتاج إلى أشخاص لكتابة وتدقيق الوثائق وترجمتها؛ نحن بحاجة إلى أشخاص لتحسين تصميم صفحات الويب؛ حتى عملية مراجعة الأخطاء التي تم التي تم الإبلاغ عنها منذ سنوات وتحديد ما تم إصلاحه على طول الطريق هي مساهمة قيّمة.
الأسئلة الأولية¶
لكي نبدأ، سنطرح عليك بعض الأسئلة حتى نتمكن من قياس اهتماماتك وخبراتك. سيساعدنا هذا في العثور على أفضل طريقة لمساهمتك. اعمل من خلال الأسئلة، ودوّن ملاحظاتك، ثم ابحث عن أحد أعضاء فريق النحل وشاركنا إجاباتك. إذا لم تفهم السؤال المطروح - لا تقلق بشأن ذلك! أخبرنا بما تعرفه ما تعرفه، وسنعمل معًا لحلها من هناك.
- هل استخدمت BeeWare من قبل؟
إذا لم تكن قد قمت بذلك بعد، فابدأ بالاطلاع على دليل BeeWare التعليمي. سيقدم لك هذا الدليل مقدمة عن مشروع BeeWare وكيفية ترابط أجزاء المشروع مع بعضها البعض. إذا واجهت أي مشاكل أثناء متابعة الدليل، فقم بتدوين ملاحظات - لأن التأكد من عدم وجود أي شخص آخر يواجه نفس المشكلة يعد موضوعًا رائعًا لمساهمتك الأولى!
بمجرد الانتهاء من البرنامج التعليمي حتى الخطوة 4 على الأقل، انتقل إلى السؤال التالي.
- ما هي أجهزة الكمبيوتر التي لديك؟
تفرض المعدات التي لديك قيودًا عملية على ما يمكنك المساهمة به. على سبيل المثال، إذا كان لديك جهاز كمبيوتر محمول يعمل بنظام Windows، فلن تتمكن من العمل على أي شيء يتعلق بنظام iOS. هل يعمل جهاز الكمبيوتر المحمول الخاص بك بنظام Windows أو macOS أو Linux أو أي نظام آخر؟ هل هاتفك يعمل بنظام iOS أو Android؟ هل تم توفير أجهزتك من قبل صاحب العمل أم أنها أجهزتك الشخصية؟
- ما مدى خبرتك في كتابة أكواد لغة Python؟
هل أنت جديد في مجال البرمجة؟ أم أنك خبير في لغة Python؟ أم أنك خبير في البرمجة ولكنك بدأت لتوك في تعلم لغة Python؟ أم أنك خريج حديث من برنامج تدريبي مكثف؟ نريد أن نجد مشكلة تتناسب مع مستوى خبرتك.
- هل أنت على دراية بعمليات المساهمة في GitHub؟
هل تستخدم GitHub (أو موقعًا مشابهًا لمشاركة الأكواد) لاستضافة أكوادك الخاصة
أو المساهمة في مشاريع الآخرين؟ هل تعرف ما هو CI (التكامل المستمر)؟ هل ساهمت
في مشروع يحتوي على خطافات ما قبل الالتزام؟ إذا طلبت منك "rebase PR الخاص بك
مقابل الرئيسي"، هل ستعرف ماذا تفعل؟
- هل سبق لك المساهمة في مشروع مفتوح المصدر من قبل؟
هل شاركت في سباق سريع في الماضي؟ هل سبق لك أن قدمت طلب سحب (PR) إلى مشروع مفتوح المصدر؟ هل أنت على دراية بكيفية استخدام GitHub لإنشاء طلب سحب؟
- هل لديك أي مهارات خاصة أخرى قد تكون مفيدة؟
هل أنت على دراية بواجهة برمجة تطبيقات الرسوميات (GUI API) (مثل WinForms أو Cocoa أو GTK)؟ هل لديك معرفة عميقة بخصائص نظام تشغيل معين؟ هل أنت خبير في لغة برمجة أخرى غير Python؟ إذا لم تكن لديك أي مهارات خاصة، فلا مشكلة في ذلك - ولكن إذا كان لدينا خبير في Windows، فنحن نريد أن نتأكد من أن هذه المهارات يتم الاستفادة منها بشكل جيد.
- لماذا انضممت إلينا وما الذي يثير اهتمامك؟
"بدا الأمر وكأنه مشروع ودود" هو جواب مناسب تمامًا. ومع ذلك، إذا كان هناك المزيد من الأسباب التي دفعتك للانضمام إلينا اليوم، فأخبرنا بها. هل أنت مهتم بتطوير الأجهزة المحمولة أو أجهزة الكمبيوتر المكتبية؟ التعبئة والتغليف؟ مواقع الويب؟ تطبيقات وحدة التحكم؟ إذا لم يكن لديك اهتمام محدد، فما الذي يبدو أكثر إثارة للاهتمام بناءً على ما رأيته عن BeeWare حتى الآن؟
والآن، ابحث عن أحد أعضاء فريق النحل لمشاركة إجاباتك. قد يسألون بعض أسئلة المتابعة؛ ولكن بعد ذلك سيوجهونك إلى مجال يمكنك أن تكون قادراً على تقديم مساهمة فيه.
ابحث عن مشكلتك¶
إذا كنت قد تحدثت إلى أحد أعضاء فريق Bee، فمن المحتمل أنه قد أرشدك إلى جزء من مشروع BeeWare يمكنك المساهمة فيه؛ وقد يكون قد اقترح عليك حتى مشكلة معينة للعمل عليها. إذا لم يحدد لك مشكلة معينة، فمن المحتمل أنه أرشدك إلى "المشاكل الجيدة الأولى" لهذا المشروع. ماذا يعني ذلك؟
يوفر GitHub قائمة بالمشكلات التي تسمح ل BeeWare (وغيرها من وغيرها من المشاريع) بتتبع جميع المشاكل التي تم الإبلاغ عنها - والتي تتضمن التي تتضمن الأخطاء الصريحة، والسلوك غير المتوقع الذي قد يكون خطأ, طلبات للحصول على ميزات جديدة، طلبات لمزيد من التوثيق - أي شيء قد يكون وسيلة يمكن من خلالها تحسين BeeWare. عندما يتم الإبلاغ عن مشكلات جديدة سيقوم فريق Bee Team بالإبلاغ عن بعض منها على أنها مشكلات تناسب المساهمين لأول مرة - المشكلات التي لا تتطلب إصلاحًا * فوريًا*، لكنها محددة جيدًا أو يسهل إعادة إنتاجها، وربما لديها دليل جيد على السبب الأساسي. يتم وسم هذه المشكلات ب "مشكلة مشكلة أولى جيدة" لتسهيل العثور عليها.
لتصفية قائمة مشكلات GitHub حسب العلامة "good first issue"، اتبع الخطوات التالية:
- انقر على زر "التصنيفات" أعلى قائمة المشكلات لتنشيط القائمة المنسدلة.
- اكتب كلمة "جيد" في مربع البحث أعلى القائمة المنسدلة.
- انقر على "العدد الأول الجيد" في القائمة المفلترة.
تصفية مشكلات GitHub حسب علامة "المشكلة الأولى الجيدة".
بمجرد عثورك على مشكلة تبدو مثيرة للاهتمام، اقرأ أي التعليقات على المنشور، وانشر تعليقًا في المناقشة تقول فيه أنك بأنك تبحث في المشكلة (على سبيل المثال، "أبحث في هذا الأمر في PyCon US 2025"). لا تقوم BeeWare صراحةً ب "تعيين" المشكلات - نحن نقبل المساهمات من أي شخص. ومع ذلك، في حالة العدو السريع، نحتاج إلى التأكد من أننا لا ينتهي بنا الأمر بشخصين يعملان على نفس المشكلة المشكلة - ترك تعليق هو وسيلة خفيفة الوزن للتنسيق بين المساهمين.
إذا كنت لا تزال غير قادر على العثور على أي شيء ترغب في القيام به، فابحث عن أحد أعضاء فريق Bee وسيساعدك في تضييق نطاق البحث إلى مشكلة معينة.
إعداد بيئة التطوير¶
بمجرد عثورك على مشكلة، ستحتاج إلى إعداد بيئة التطوير الخاصة بك حتى تتمكن من العمل على الإصلاح. كل مشروع من مشاريع BeeWare له دليل مساهمة خاص به:
إذا لم يكن المشروع مدرجًا في هذه القائمة، فتحقق من المشروع README للحصول على التفاصيل حول كيفية الإعداد. إذا كانت أي من التعليمات غير منطقية (أو أو لم تتمكن من العثور على تلك التعليمات)، فابحث عن أحد أعضاء فريق Bee، و وسيقومون بحل المشكلة. وإذا كنت تعتقد أنه يمكنك تحسين التعليمات حتى لا يواجه الأشخاص الآخرون نفس المشكلة، فإن تحسين دليل المساهمة هو مساهمة قيمة!
الآن يمكنك البدء في العمل على مشكلتك!
ماذا يحدث بعد تقديم طلب الإقامة الدائمة؟¶
بمجرد إرسال طلب السحب الخاص بك، واجتياز طلب السحب جميع الفحوصات الآلية، تصبح جاهزًا للمراجعة. دع أحد أعضاء فريق الأساسية بأن لديك طلب سحب جاهز للمراجعة، وسيقومون بإلقاء نظرة.
إذا كانت هذه أول علاقات عامة لك، فمن المحتمل جداً أن تجد المراجعة بعض المشاكل. قد تكون هذه مشكلة لم تضعها في الحسبان، أو قد تكون شيفرة لم تتبعها. لا تثبط عزيمتك! لا أحد - ولا حتى حتى الفريق الأساسي - يحصل على علاقات عامة صحيحة 100% من المحاولة الأولى.
بمجرد اجتياز PR للمراجعة، سيقوم المراجع بدمج PR - وبذلك تكون قد انتهيت! تهانينا - لقد ساهمت في BeeWare! إذا كانت هذه هي مساهمتك الأولى في BeeWare، فقد حصلت أيضًا على BeeWare Challenge Coin - ابحث عن أحد أعضاء الفريق الأساسي، وسوف يعطونك عملة معدنية!
النجدة! أنا عالق!¶
إذا واجهتك مشكلة في أي نقطة على طول الطريق، ابحث عن أحد أعضاء من فريق النحل. لا تخف من طرح أي سؤال. إذا كنت عالقًا، فنحن نريد أن نخرجك من هذا المأزق. إذا كنت في حيرة من أمرك، فذلك لأن الموضوع معقد، ونحن لم نشرحه بما فيه الكفاية. نحن حريصون على المساعدة - ونريد التأكد من حصولك على سباق سريع ناجح.
ماذا لو لم أكمل مساهمتي خلال السباق؟¶
لا مشكلة! يمكنك تقديم مساهمة في أي وقت. الهدف من السباقات هو تشجيعك وتمكينك من مواصلة المساهمة طوال بقية العام. فريق Bee متاح لمساعدتك في أي جزء من هذه العملية.
إذا كنت تعمل بالفعل على مشكلة GitHub أو قدمت طلب سحب (PR)، فيمكنك الاستمرار في التواصل عبر GitHub. إذا كانت لديك أسئلة أخرى أو كنت بحاجة إلى مساعدة فورية، فإن أفضل مكان لتجدنا فيه هو خادم BeeWare Discord. نتطلع إلى مواصلة العمل معك!
تحسين هذا الدليل¶
إذا كانت لديك أي اقتراحات حول كيفية تحسين دليل العدو السريع هذا، فأخبرنا بذلك. ما الذي نجح معك؟ وما الذي لم ينجح؟ ما الذي يمكننا القيام به بشكل أفضل؟ وتذكر: إصلاح مشكلة مشكلة في دليل العدو السريع هذا يعتبر مساهمة في BeeWare!