doc/user.org: Mise à jour de la doc sur le barème

doc/user/manual.org

@@ -130,20 +130,36 @@
          des notes qui ont été gelées.
 *** Définition du barème
     Pour définir un barème, il faut cliquer sur le bouton /Gérer les
-    exercices/. Ce même bouton permettra, par la suite, de modifier le
-    barème.  S'ensuit l'ouverture d'une fenêtre modale, permettant d'entrer le
-    numéro d'exercice (première colonne), le nom de l'exercice (deuxième
-    colonne) et le nombre de points sur lequel est noté cet exercice
-    (troisième colonne).  En bas de la fenêtre, est défini le nombre de points
-    total du TP. Si la somme des points des exercices ne correspond pas à la
-    note totale du TP, le barème est automatiquement ajusté afin de faire
-    correspondre les notes des exercices à la note du TP.
+    exercices/. Ce même bouton permettra, par la suite, de modifier le barème.
+    S'ensuit l'ouverture d'une fenêtre modale, permettant d'entrer le nom de
+    l'exercice (première colonne), le nombre de points de cet exercice
+    (deuxième colonne), le nombre de points bonus ou malus (troisième
+    colonne), puis le mode de notation (numérique ou un barème de lettres).
+    En bas de la fenêtre, est défini le nombre de points total du TP. Si la
+    somme des points des exercices ne correspond pas à la note totale du TP,
+    le barème est automatiquement ajusté afin de faire correspondre les notes
+    des exercices à la note du TP (dans le cas où ce comportement n'est pas
+    souhaité, il faut décocher la case en bas à droite).
 
     [[file:images/sujet_bareme.jpg]]
 
-    Dans l'exemple ci-dessus, le premier exercice sera automatiquement mis sur
-    15 et le second sur 5, ce qui préserve la proportion initialement choisie
-    entre les deux exercices.
+    Dans l'exemple ci-dessus, les trois exercices valent 39 points. On demande
+    un barème sur 30 points, les notes de chaque exercice seront donc
+    recalculées de manière à fournir un total qui fait 30 points.
+
+    Par défaut les étudiants commencent avec la note maximale attribuée à
+    l'exercice (ce comportement est défini lors de la création du sujet, selon
+    qu'on choisit /max/ ou /min/ pour la note initiale). Il est possible de
+    modifier ce comportement ponctuellement en utilisant le champ bonus/malus.
+    Si la note initiale est la note maximale, on peut avoir une note initiale
+    plus faible en mettant un malus (une note négative) à un ou plusieurs
+    exercices.  On peut avoir le comportement inverse en mettant un bonus,
+    lorsque la note initiale est la minimale.
+
+    Dans l'exemple ci-dessus, le dernier exercice pourra être vu comme un
+    exercice bonus (puisque tout le monde commence avec zéro sur cet
+    exercice).  Dans une telle situation, il peut être judicieux de ne pas
+    demander à ajuster les notes des exercices.
 
 **** Affichage du barème et gestion                                     :dev:
      L'affichage du barème est géré dans le fichier