نفّذ أدوات إضافية

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

هناك نوعان من أدوات المسار:

  • الإنتاج: تقدّم وظيفة أساسية في تجربة تعلّم تلك اللغة
  • الصيانة: تساعد في صيانة المسار

أدوات الإنتاج

هناك (حاليًا) ثلاث أدوات للإنتاج:

  • مشغّلات الاختبارات: تشغّل اختبارات التمرين على كود الطالب. (مطلوبة)
  • الممثّلات: تنشئ تمثيلًا موحَّدًا للحل. (اختيارية)
  • المحلّلات: تقيّم ما يسلّمه الطلاب تلقائيًا وتقدّم تعليقات بأسلوب المرشدين. (اختيارية)

أدوات الصيانة

وللمساعدة في صيانة المسار، يمكن أيضًا بناء:

أي أداة تنفّذ؟

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

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

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

للبدء في بناء ممثّل، راجع وثيقة إنشاء ممثّل من الصفر.

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

في هذه المرحلة، يُرجَّح أن يعود التركيز إلى إضافة مزيد من التمارين. ولتسريع إضافة تمارين جديدة، فكّر في بناء مولّد اختبارات.

التنفيذ

عادةً ما تُكتب أدوات المسار (في الغالب) بلغة المسار.

Caution

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

النشر

تُحزَّم أدوات الإنتاج وتُشغَّل في صورة حاوية Docker. وتُنشر صور Docker الخاصة بالأدوات تلقائيًا باستخدام سير عمل GitHub Actions.

في المقابل، لا تُنشر أدوات الصيانة.