إرشادات المساهمة الجديدة

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

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

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

القاعدة الأساسية التي ينبغي استيعابها هي أننا نناقش الأفكار وBug والمشكلات على منتدانا، ونناقش التغييرات الناتجة على الكود على GitHub (في مراجعات طلبات السحب). والقاعدة الثانية هي أننا نناقش الأمور قبل القيام بها (باستثناء المشرفين المستقلّين). ويتيح منتدانا للمساهمين والمشرفين في مختلف المسارات تبادل المعرفة والحكمة حول مجموعة واسعة من اللغات والأفكار، دون الحاجة إلى متابعة 300 مستودع مختلف على GitHub وإغراق إشعاراتهم.

إرشادات محدّثة

الحصول على الدعم

• إذا واجهت أي عقبة قبل حلّ تمرين (مثل تثبيت واجهة سطر الأوامر، أو تشغيل الاختبارات، أو التعثر في منطق التمرين أو متطلباته)، فإن قنوات الدعم لدينا هي فئة "Exercism Support" على المنتدى وقناة #get-help على خادم Discord.
• لا نستخدم GitHub أو البريد الإلكتروني لطلبات الدعم.
• إذا كنت قد حللت تمرينًا ولديك أسئلة عنه، فاطلب الإرشاد على Exercism نفسه.

الإبلاغ عن Bug والمشكلات

• يجب فتح جميع Bug والمشكلات على منتدانا، حيث يستطيع عدد كبير من الأشخاص المساعدة في فهم المشكلة وحلها.
  • إذا كانت المشكلة متعلقة بلغة برمجة، فاستخدم فئة Programming/xxx المعنية.
  • وإذا كان Bug على الموقع، فاستخدم فئة "Bugs & Feature Requests".
• ستُغلق مشكلات GitHub تلقائيًا في العادة، وسيُوجَّه صاحبها إلى المنتدى (مع رابط بنقرة واحدة لنسخ مشكلته ولصقها، كما هو الحال حاليًا).
• يمكن لمشرفي المسارات إيقاف الإغلاق التلقائي للمشكلات، لكن القناة الرسمية تبقى المنتدى.

فتح طلبات السحب

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

الخلاصة

تبقى أولويتنا الأولى الحفاظ على وقت مساهمينا الأساسيين وطاقتهم الذهنية، فبدونهم لا يستطيع Exercism أن يواصل عمله. لكننا نريد أيضًا أن نضمن أن يبقى Exercism مكانًا يستطيع فيه الوافدون الجدد المشاركة دون حواجز مُقيّدة أكثر من اللازم، ومكانًا نشجّع فيه هؤلاء الأشخاص وندعمهم ليصبحوا مساهمين أساسيين بأنفسهم!

أنا متشوّق لرؤية أثر هذه التغييرات على المساهمات خلال الأشهر القليلة المقبلة. سنراجع الأمور مرة أخرى في منتصف عام 2024.