[API] Spécification sur les contrôles entre exercices et activités

[nborie]

Si les spécifications sur les exercices sont parfaites, le sieur Callé va pisser des activités à la vitesse du cheval au galop de la marrée montante d’équinoxe du Mont Saint-Michel (la pression sur CC....).

C'est là --> API des exercices

• Il y a beaucoup de chose qui ne sont pas claires.... (j'ai posé un premier jet...)
• Comment différencier efficacement les types de feedback ?
• Faut-il des feedback périssables (immédiat sinon rien) et des feedback différables (maintenant ou plus tard) ?
• Attrape-t-on un maximum de cas d'utilisation ?
• Est-ce suffisamment extensibles ?

S'il l'on doit casser la rétro-compatibilité pour amorcer un grand pas en avant, il faut absolument le faire avant septembre (fin août max).

N'hésitez pas à éditer directement le fichier API des exercices au bout du lien... Si vous avez peur que vos idées ne fassent pas consensus il suffit de mettre vos initiales avant une assertion et de poser la question en répondant à cette issue, ça permet d'entériner les choix et d'avancer.

[magdalena-kobylanski]

je rajouterai deux choses :
réponse indique si la réponse est juste ou non mais ne donne pas la bonne réponse (essaie encore)
indice de confiance pouvoir remplacer le bouton valider par trois ou quatre boutons du type "je le sais" "je le pense" "peut-être" "j'en sais rien". La corrélation entre le niveau de validation et les réponses pourrait être intéressant ..

Sur les feedbacks, j'imagine qu'ils nécessitent toujours une analyse fine de la réponse de l'élève ?

Ensuite selon les cas, soit l'étudiant recommence avec le même grain sans pénalisation, soit avec de la pénalisation... soit encore il peut demander à recevoir la bonne réponse...soit recommencer avec une nouvelle seed, soit avancer plus loin....

[ddoyen]

Voilà une proposition que j'avais préparé avant de voir @nborie avait déjà commencé à écrire des choses. Je la mets telle quelle mais je vais aller voir ce qu'a écrit Nicolas.

Clés de contenu. Ces clés sont produites par l'exécution du builder et du grader.

title : Chaîne Markdown/HTML. Titre de l'exercice.

text : Chaîne Markdown/HTML. Enoncé de l'exercice.

form : Chaîne Markdown/HTML. Interface de réponse de l'exercice.

score : Entier entre -1 et 100. Score de l'exercice. Le score -1 signifie que la réponse est invalide d'un point de vue formel.

feedback : Chaîne Markdown/HTML. Rétroaction corrective.

solution : Chaîne Markdown/HTML. Solution de l'exercice.

hint : Chaîne Markdown/HTML ou liste/dictionnaire de chaînes Markdown/HTML. Indication(s) pour la résolution de l'exercice.

Paramètres de configuration pédagogique. Ces paramètres sont fournis à playexo en complément du dictionnaire de l'exercice produit par le builder et le grader.

nb_instances : Entier (ou null). Nombre de nouvelles instances de l'exercice que l'élève peut tirer. Si nb_instances vaut null, l'élève peut demander une nouvelle instance autant de fois qu'il le souhaite.

nb_attempts : Entier (ou null). Nombre de tentatives que l'élève peut faire sur chaque instance. Si nb_attempts vaut null, l'élève peut faire autant de tentatives qu'il le souhaite.

display_score : Booléen. Si display_score vaut true, le score et/ou un message de réussite/échec est affiché après chaque tentative.

display_feedback : Booléen. Si display_feedback vaut true, le message de rétroaction (contenu dans la clé feedback) est affiché après chaque tentative.

allow_hint : Booléen. Si allow_hint vaut true, le ou les indications (contenues dans la clé hint) sont affichables grâce à un bouton dans la barre d'exercice.

score_if_hint : Booléen. Si score_if_hint vaut false, le score sur une instance donnée n'est plus améliorable quand l'indication a été affichée par l'élève.

allow_solution : Booléen. Si allow_solution vaut true, la solution de l'exercice (contenues dans la clé solution) est affichable grâce à un bouton dans la barre d'exercice. Le score sur une instance donnée n'est plus améliorable quand la solution a été affichée.

countdown : Entier (ou null). Temps en secondes pour répondre à l'exercice. Le compte à rebours est affiché dans la barre d'exercice. Si countdown vaut null, le temps n'est pas limité.