Comment donner un retour sur les représentations

Donner un retour sur une représentation est différent de donner un retour sur une solution unique.

Le retour sur une représentation s'applique à plusieurs solutions

Le point clé du retour sur une représentation, c'est qu'il s'applique à plusieurs solutions. Tout ce que le representer normalise ne doit pas être commenté, car on n'a aucun moyen de savoir quelle était la syntaxe d'origine pour une solution donnée.

Par exemple, de nombreux representers normalisent les espaces blancs d'une solution. Par conséquent, même si la solution affichée dans l'interface de retour sur les représentations peut présenter des problèmes de formatage, il ne faut pas les commenter, car d'autres solutions ayant la même représentation pourraient ne pas avoir ces problèmes de formatage.

Un autre exemple est le nom des variables, fonctions, méthodes ou classes. Comme les representers peuvent normaliser les noms d'identifiants, il ne faut pas les commenter. Même si ton representer ne normalise pas les noms d'identifiants actuellement, il ne faut pas les commenter pour autant, car cette normalisation sera probablement ajoutée à un representer plus tard.

Ne duplique pas les commentaires de l'analyseur

Comme les apprenants verront à la fois les commentaires du representer et ceux de l'analyseur, veille à ne pas dupliquer les commentaires. Pour t'aider, les commentaires de l'analyseur sont affichés sur la page de retour de la représentation.

Le retour préliminaire

Si une représentation a un retour et que l'une des deux conditions suivantes est remplie :

• la version du representer de l'exercice a changé, ou
• la version de la représentation a changé

une nouvelle représentation est alors créée.

Le retour de l'ancienne représentation s'applique probablement aussi à la nouvelle, mais on ne peut pas en être sûr. Par conséquent, on copie le retour de l'ancienne représentation comme retour préliminaire pour la nouvelle représentation. Le retour préliminaire de la nouvelle représentation n'entraîne pas l'application de ses commentaires aux solutions qui ont cette représentation. À la place, le retour préliminaire sert à préremplir le retour quand un supermentor veut donner un retour sur la nouvelle représentation.