تصنيفات المشاكل

التصنيفات هي ميزة رائعة في GitHub تتيح لك فلترة المشاكل وطلبات السحب. وهي تساعدك في العثور على مشاريع ممتعة تناسب مستوى خبرتك.

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

الحجم

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

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

نطاق سلطة

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

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

الحالة

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

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

النوع

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

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

الفئة

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

المشروع

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

للاطّلاع على ما إذا كان هناك تصنيف للمشروع الذي يهمّك، راجِع القائمة الكاملة للتصنيفات:

غير ذلك

وكما هو الحال مع أي مجموعة من العناصر، هناك بعض الحالات الشاذة التي يجب معرفتها أيضًا. قد لا تكون هذه التصنيفات مفيدة عند البحث عن مشكلة للعمل عليها، ولكنها تظل مفيدة.

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