Après avoir lancé le parcours avec les 20 premiers exercices ou plus et un exécuteur de tests, l'attention doit se porter sur la mise en place de l'outillage de parcours supplémentaire.
Il existe deux types d'outillage de parcours :
- Production : apporter un élément essentiel à l'expérience d'apprentissage de ce langage
- Maintenance : faciliter la maintenance du parcours
Outillage de production
Il existe (pour l'instant) trois outils de production :
-
Exécuteurs de tests : exécutent les tests d'un exercice sur le code d'un apprenant. (obligatoire)
-
Representers : créent une représentation normalisée d'une solution. (facultatif)
-
Analyseurs : évaluent automatiquement les soumissions des apprenants et fournissent des commentaires dans le style d'un mentor. (facultatif)
Outillage de maintenance
Pour faciliter la maintenance du parcours, on peut également construire :
-
Générateurs de tests : génèrent ou mettent à jour automatiquement les tests d'un exercice et l'interface de code de l'apprenant. (facultatif)
Quel outil implémenter ?
Les outils de production sont plus importants que les outils de maintenance.
À ce stade, tu devrais avoir mis en place un exécuteur de tests (sinon, consulte la documentation Construis un exécuteur de tests).
Maintenant que l'exécuteur de tests est en place, le prochain outil sur lequel travailler est le Representer.
Les objectifs du Representer et de l'analyseur se recoupent en partie, mais on te recommande de commencer par le Representer, pour les raisons suivantes :
- les Representers sont généralement (bien) plus faciles à implémenter
- les Representers peuvent avoir un impact bien plus important que les analyseurs sur la charge de mentorat, en donnant davantage de moyens aux mentors
- les Representers s'appliquent à tous les exercices, alors que les analyseurs ne ciblent généralement que certains exercices ou un sous-ensemble
Pour te lancer dans la création d'un Representer, consulte le document Crée un Representer à partir de zéro.
Enfin, une fois le Representer en place, le dernier outil à construire est l'analyseur.
Pour te lancer dans la création d'un analyseur, consulte le document Crée un analyseur à partir de zéro.
À ce stade, il est probablement temps de se recentrer sur l'ajout de nouveaux exercices.
Pour ajouter des exercices plus rapidement, envisage de construire un générateur de tests.
Implémentation
L'outillage d'un parcours est généralement (en grande partie) écrit dans le langage du parcours.
Bien que tu sois libre d'utiliser d'autres langages, chaque langage supplémentaire rendra la maintenance du parcours plus difficile, tout comme la contribution à celui-ci.
C'est pourquoi on te recommande d'utiliser le langage du parcours quand c'est possible, car cela facilite la maintenance et la contribution.
Déploiement
Les outils de production sont empaquetés et exécutés dans un conteneur Docker.
Les images Docker de l'outillage sont déployées automatiquement à l'aide d'un workflow GitHub Actions.
Les outils de maintenance ne sont pas déployés.
