Doc évaluation et reprise page BUT.

README.md

@@ -21,8 +21,9 @@ Il est recommandé de créer un virtualenv:
 python3.11 -m venv venv
 source venv/bin/activate
 ```
+(n'importe quelle version de python récente fera l'affaire).
 
-puis d'y installer les composants suivants:
+Puis installer les composants suivants dans ce virtualenv:
 
 ```bash
 pip install mkdocs
@@ -31,8 +32,24 @@ pip install mkdocs-material
 pip install mkdocs-plugin-inline-svg
 ```
 
+## Génération de la doc
+
 Pour générer le site:
 
 ```bash
 mkdocs build
 ```
+
+Pour lancer un serveur local permettant d'afficher la doc, avec rafraichissement
+automatique dès qu'un fichier source est modifié:
+
+```bash
+mkdocs serve
+```
+
+Pour le reste voir la documentation de [MkDocs](https://www.mkdocs.org/).
+
+## WIP
+
+- reprendre la page BUT.md
+-

docs/BUT.md

@@ -1,13 +1,14 @@
 # Le Bachelor Universitaire de Technologie (BUT)
 
-Formation en trois ans dispensées par les IUT français, introduite en 2021, et
+Le BUT est une formation en trois ans dispensées par les IUT français,
-basée sur une forme d'approche par compétences nécessitant un système
+introduite en 2021, et basée sur une forme d'approche par compétences
-d'évaluation spécifique.
+nécessitant un système d'évaluation spécifique.
 
 Cette page décrit les principaux éléments du BUT utiles à comprendre pour le
 gérer avec ScoDoc. Vous trouverez ensuite un exemple de mise en place des
-semestres d'un BUT ici: [Modélisation BUT: exemple de la spécialité
+semestres d'un BUT ici:
-Informatique](BUTExempleInfo.md). Pour les curieux et les développeurs, la page
+[Modélisation BUT: exemple de la spécialité Informatique](BUTExempleInfo.md).
+Pour les curieux et les développeurs, la page
 [modélisation des parcours BUT](ModelisationParcoursBUT.md) donne quelques
 détails sur la façon dont ScoDoc organise les objets du BUT.
 
@@ -23,33 +24,35 @@ style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>
   en jury. Une UE est rattachée à une *formation*.
 
 - Module: dans ScoDoc, un module désigne une dispositif pédagogique, évalué.
-  Dans les formations BUT, le module prend la forme d'une *ressource* ou d'une
+  Dans les formations BUT, le module prend la forme d'une **ressource** ou d'une
-  SAE (*situation d'apprentissage et d'évaluation*). Un module est rattaché à
+  **SAE** (*situation d'apprentissage et d'évaluation*). Un module est rattaché à
   une (seule) UE.
 
   Dans le BUT, un module est aussi associé à une ou ou plusieurs UE, cette
-  association étant affecté de *coefficients* (une valeur par UE associée).
+  association étant affectée de *coefficients* (une valeur par UE associée).
 
 - Évaluation: dispositif produisant une note pour les étudiants inscrits à un
   module. L'évaluation est associée à des coefficients.
 
 ## Structure des formations par compétences de type BUT
 
-L'architecture d'une formation BUT est définie par les éléments suivants:
+L'architecture d'une formation BUT est définie par un *référentiel de
+compétence* définissant notamment les éléments suivants:
 
-- Compétence
+- **Compétence**
-  - Niveau
+    - Niveau
-  - Composantes essentielles ("En respectant les règles métiers...")
+    - Composantes essentielles ("En respectant les règles métiers...")
-  - Situations professionnelles ("Surveillance de la qualité de la
+    - Situations professionnelles ("Surveillance de la qualité de la
-    production...")
+      production...")
 
-- Niveaux de compétence: associés à une année. Attention, le niveau 1 commence
+- **Niveaux de compétence**: la compétence est divisée en niveaux, associés à
-  parfois en deuxième année.
+  une année de la formation. Le premier niveau 1 commence souvent en première
-  - Numéro (1, 2, 3)
+  année (BUT1), mais parfois en deuxième année (BUT2). Le niveau est défini par
-  - Titre
+    - Numéro (1, 2, 3)
-  - Apprentissages critiques (AC): "Identifier les dysfonctionnements du réseau local..."
+    - Titre
+    - Apprentissages critiques (AC): "Identifier les dysfonctionnements du réseau local..."
 
-Chaque niveau se décompose en deux UE (aka "regroupement cohérent d'UE"), en
+Chaque niveau de compétence sera associé à deux UE (aka "regroupement cohérent d'UEs"), en
 semestres impair et pair d'une année scolaire.
 
 La figure ci-dessous indique la correspondance entre compétences (découpées en
@@ -67,12 +70,14 @@ nuls (pas de coefficients négatifs).
 
 ### Coefficients des SAÉ et ressources
 
-Les coefficients des modules (ressources et SAÉ) sont fixés par le PN (*adapté
+Les coefficients des modules (ressources et SAÉ) sont fixés par le programme de
-localement*).
+formation (basé sur des préconisations nationales *adaptées localement*). Le
+programme spécifie la liste et les coefficients des modules, il est voté en
+CFVU et ne doit donc pas être modifié en cours d'année.
 
 Traditionnellement, chaque module $m$ est noté par une note (moyenne de ses
-évaluations) représentée par le nombre $\mu_m$. Si $c_{u,m}$ désigne le coefficient du
+évaluations) représentée par le nombre $\mu_m$. Si $c_{u,m}$ désigne le
-module $m$ dans l'UE $u$, la moyenne d'UE de l'étudiant est 
+coefficient du module $m$ dans l'UE $u$, la moyenne d'UE de l'étudiant est
 
 $$\mu_u = \frac{1}{\sum_m c_{u,m}} \, \sum_{m \in u} c_{u,m} \, \mu_m$$
 
@@ -93,7 +98,7 @@ Un autre exemple, cette fois avec des coefficients différents et un nombre plus
 réduit d'apprentissages critiques:
 ![but-ref-comp-ex-commente](fig/but-ref-comp-ex-commente.png)
 
-### Note d'un module
+### Poids des évaluations
 
 La note (moyenne) d'un module (SAÉ ou ressource) se calcule à partir de ses
 évaluations. Chaque évaluation est pondérée, par un poids $p$ est fixé par
@@ -101,6 +106,11 @@ l'enseignant. Ce poids joue le même rôle que le coefficient d'une évaluation
 classique, mais peut se décliner en plusieurs valeurs, une par UE associée au
 module.
 
+!!! warning "Attention"
+    En BUT, la moyenne d'un module n'est pas un nombre unique: il y a une
+    moyenne différente par UE liée à ce module.
+
+
 Soit $n_e$ la note à l'évaluation $e$ du module $m$, et $p_{e, u}$ son poids
 vers l'UE $u$. La somme des notes d'un module pour l'UE $u$ est:
 
@@ -118,8 +128,8 @@ La moyenne d'un étudiant dans un module est un vecteur, car on a une note moyen
 $$\mu_{m, u} = \frac{\sum_e p_{e,u} \, n_e}{\sum_{e} \, p_{u,e}}$$
 
 Toutefois, une moyenne *scalaire* (un nombre entre 0 et 20) est calculée à
-titre indicatif (et sera éventuellement utilisée dans certaines fonctions de
+titre indicatif (mais n'est pas présentée aux étudiants dans les bulletins pour
-ScoDoc conçues avant le BUT):
+ne pas les induire en erreur):
 
 $$\mu_m = \frac{\sum_e (\sum_u p_{e,u}) \, n_e}{\sum_{u,e} \, p_{u,e}}$$
 
@@ -133,8 +143,10 @@ L'exemple suivant illustre ce mode de calcul:
 
 <img src="/fig/but-exemple-calcul-notes.png" width="70%">
 
-Par ailleurs, il est (parfois, peut-être) utile de calculer des moyennes par
+Dans ScoDoc, on va éditer les coefficients des modules sur cette page
-pôles au sein de l'UE: pôle SAÉ, pôle ressource.
+<img src="/screens/but-info-edit-coefs-S4.png" width="40%">
+
+(voir [l'exemple complet du paramétrage d'un BUT](BUTExempleInfo.md)).
 
 ### Validation d'une UE
 
@@ -149,29 +161,38 @@ peuvent entrainer la validation d'UE a posteriori.
 
 ### Capitalisation
 
-Les UE sont capitalisables, c'est à dire qu'un étudiant conserve les UEs
+Dans le BUT comme dans toutes les formations LMD, les UEs sont capitalisables,
-obtenues (avec moyenne > 10/20) s'il arrête temporairement ses études ou redouble un semestre.
+c'est à dire qu'un étudiant conserve les UEs obtenues (avec moyenne > 10/20)
+s'il arrête temporairement ses études ou redouble un semestre.
 
-En cas de redoublement, l'étudiant qui choisi de répéter une UE capitalisée conserve le
+En cas de redoublement, l'étudiant qui choisi de répéter une UE capitalisée
-résultat antérieur sauf s'il obtient une meilleure moyenne.
+conserve le résultat antérieur sauf s'il obtient une meilleure moyenne.
 
-### Moyenne générale
+### Moyenne générale indicative
 
-La validation du BUT ne considère pas de "moyenne générale": chaque
+La validation du BUT ne considère pas de "moyenne générale": chaque regroupement
-regroupement d'UE est considéré indépendamment (aucunes compensations entre UE
+d'UE est considéré indépendamment (aucune compensations entre UEs relevant de
-relevant de compétences différentes).
+compétences différentes).
 
-Cependant, ScoDoc calculera une moyenne générale indicative, utile pour
+Cependant, ScoDoc peut calculer une moyenne générale indicative, utile pour
 certaines opérations (tri de tableaux, création de groupe de niveaux semblables,
 avis de poursuite d'études, etc.).
 
-Cette moyenne sera calculée en utilisant les ECTS de chaque UE du semestre
+Cette moyenne indicative est calculée en utilisant les ECTS de chaque UE du semestre
 considéré:
 
 $$ g = \frac{1}{\sum_{u \in \cal S} \mbox{ects}_u} \sum_{u \in \cal S} \mbox{ects}_u \,  \mu_u $$
 
 Attention, les UEs sans notes sont ici considérées comme ayant une moyenne
-nulle. En début d'année, la moyenne générale indicative sera donc souvent très basse.
+nulle. En début d'année, la moyenne générale indicative sera donc souvent très
+basse.
+
+!!! note "Note"
+    Il est possible, dans chaque semestre, de désactiver le calcul de la moyenne
+    générale indicative si on ne souhaite pas en tenir compte.
+    <img src="/screens/but-option-moy-indicative.png" width="50%">
+
+
 
 ### Passage d'une année à l'autre
 
@@ -183,9 +204,11 @@ Les conditions de passages vers l'année suivante sont:
  2. Aucun regroupement cohérent d’UE < 8.
  3. Cas particulier du passage en BUT 3: nécessité d’avoir validé toutes les UE
     du BUT 1.
- 
+
 Note: La validation des deux UE du niveau d’une compétence emporte la validation de
- l’ensemble des UE du niveau inférieur de cette même compétence.
+ l’ensemble des UEs du niveau inférieur de cette même compétence.
+
+Voir la [page dédiée aux jurys BUT](BUTJurys.md).
 
 ### Redoublements
 
@@ -221,33 +244,37 @@ bonus pourra donc être appliqué au niveau des moyennes UE: soit sur toutes
 (bonus fixe ajouté à chaque UE), soit sur un sous-ensemble des UE du semestre.
 
 Les règles précises du calcul de ce bonus sont malheureusement variables d'un
-établissement à l'autre: ScoDoc 7 proposait plus d'une douzaine de variantes. La
+établissement à l'autre: ScoDoc 9 propose actuellement (mars 2024)
-situation sera identique avec le BUT et ScoDoc 9, et la mise en place d'une
+quarante-trois (43, vous avez bien lu) modes de calculs différents. La mise en
-fonction spécifique dans ScoDoc demandera un paramétrage particulier: voir [la
+place d'une fonction spécifique dans ScoDoc demande un paramétrage particulier:
-page sur les bonus et malus](BonusMalus.md).
+voir [la page sur les bonus et malus](BonusMalus.md).
 
-## Éditer ou importer une formation
+## Éditer ou importer une formation et référentiels
 
-ScoDoc permet d'importer des programmes de formations créés par d'autres
+ScoDoc permet de créer et éditer un programme de formation, et d'exporter  ou
-applications, comme Orébut, puis de les modifier pour introduire une *adaptation
+importer des formations dans un format d'échange XML.
-locale*.
 
-TODO: voir si on offre la possibilité de voir/gérer le delta entre le PN et le local.
+Les référentiels de compétences des BUTs ont été copiés depuis Orébut (application
+officielle de l'ADIUT).
 
 ## Modules et évaluations
 
+Pour des informations générales, voir la page sur [les évaluations](Evaluation.md).
+
 ### Créer une évaluation
 
-Pour fixer les poids des évaluations du module, on peut employer plusieurs méthodes:
+Pour fixer les poids des évaluations du module, on va fixer un coefficient et
+éventuellement moduler les poids vers les UEs:
 
 - un nombre (poids de l'évaluation dans le module, sans préciser si cette
   évaluation affecte plus un UE qu'une autre);
 
-- cocher des apprentissages critiques (on rappelle que les AC sont associés à des niveaux de
- compétences, donc à 2 UE consécutives);
-
 - indiquer un poids par UE.
 
+Par ailleurs, on peut cocher des apprentissages critiques (AC), associés à des
+niveaux de compétences, afin de vérifier que l'ensemble des évaluations couvre
+bien les critères préconisés dans le référentiel de compétences.
+
 #### Coefficient et poids d'une évaluation
 
 Afin de faciliter la tâche des enseignants, ScoDoc sépare le coefficient d'une
@@ -267,14 +294,19 @@ $$p_{e, u} =  w_e \, \frac{b_{e,u}}{\sum_u b_{e,u}}$$
 - Si on décoche un AC, les poids sont mis à jour, au prorata du nombre d'AC
   dans chaque UE (compétence).
 
+Voir aussi la page sur [les évaluations](Evaluation.md).
+
 ## Tableau de bord module
 
-Fonctions de base, en plus de celles déjà présentes en ScoDoc 7:
+Fonctions spécifiques au BUT:
-
-- Vérification de la conformité (tous les AC cochés dans le PN sont évalués)
 
 - Poids de chaque évaluation dans chaque UE et conformité au programme de la formation
 
+### Travaux en cours
+
+- Vérification de la conformité (tous les AC cochés dans le PN sont évalués)
+  (pas encore disponible en 9.6.x).
+
 En bas du tableau de bord du module on aura un tableau récapitulatif:
 
 <img src="/fig/but-tableau-evals-module-ok.png" width="50%">
@@ -284,43 +316,30 @@ des poids ou oubli d'une évaluation):
 
 <img src="/fig/but-tableau-evals-module-ko.png" width="50%">
 
+
 ## Bulletins de notes
 
-La quantité d'information à présenter rend la conception des bulletins de notes difficile.
+La quantité d'information à présenter rend la conception des bulletins (relevés) de notes délicate.
 
-### Modèle "Lillois"
+Pour le BUT, on propose:
+ - un bulletin semestriel avec notes des ressources, des SAÉs et résultats aux
+   UEs. Ce bulletin peut être plus ou moins détaillé, versions "long",
+   "intermédiaire" ou "court".
+ - un bulletin résumé, en une page, donnant les principaux résultats du semestre
+   et l'avancement dans l'acquisition des compétences.
 
-Proposition de l'IUT de Lille: 
+Ces documents sont disponibles aux formats web (html), PDF et json (API).
 
-- en ligne, les ressources, puis les SAÉ;
+Voir quelques propositions, sources d'inspiration pour les formats proposés par
-- en colonnes, les UE;
+ScoDoc 9 [sur cette page](BUTBulletins.md)
-- dans chaque case, le coefficient et la note obtenue;
-- on peut ajouter les évaluations (lignes);
-- on pourrait ajouter les infos habituelles en colonnes: min/max/moy/rangs/...
-
-Avantage: toutes les informations importantes sont présentées.
-
-Inconvénients (?): beaucoup de cases vides, peu synthétique, pas évident à
-exploiter pour un non spécialiste du BUT (poursuites d'études, employeurs).
-
-<img src="/fig/but-bul-lille.png" width="50%">
-
-### Modèle "Bordelais"
-
-Cette proposition a été reçue sous différentes formes de plusieurs collègues.
-L'idée est de présenter le bulletin en deux parties: d'abord les résultats de
-chaque ressource et SAE, puis les résultats de chaque UE.
-
-Un exemple préliminaire:
-
-<img src="/fig/but-bul-bdx.png" width="50%">
 
 ## Tenue des Jury BUT
 
-La tenue des jury BUT dans ScoDoc est en fait plus simple que celle des anciens DUTs, avec moins
+La tenue des jury BUT dans ScoDoc est en fait plus simple que celle des anciens
-de décisions ad-hoc (compensations plus simples, moins de cas de mise en
+DUTs, avec moins de décisions ad-hoc (compensations plus simples, moins de cas
-attente). Comme pour les formations LMD, il s'agit avant tout de constater ou
+de mise en attente). Comme pour les formations LMD, il s'agit avant tout de
-valider manuellement les Unités d'Enseignements (UEs) associées à des ECTS.
+constater ou valider manuellement les Unités d'Enseignements (UEs) associées à
+des ECTS.
 
 Avant de tenir un jury de BUT il est absolument indispensable que la formation
 et les semestre soient bien paramétrés. Voir [l'exemple complet du paramétrage
@@ -365,6 +384,7 @@ A la fin, les validations enregistrées pour cet étudiant sont:
 !!! note "Voir aussi"
 
     - [Modélisation BUT: exemple de la spécialité Informatique](BUTExempleInfo.md)
+    - [Les codes de jury en BUT](BUTCodesJury.md)
     - [Guide utilisateur](GuideUtilisateur.md)
     - [Guide du responsable de formation](GuideAdminFormation.md)
     - [Tutoriels vidéo](https://www.youtube.com/channel/UCb0JYCBRi0CsE4XFp4ByhXg)

docs/BUTBulletins.md

@@ -0,0 +1,33 @@
+# Bulletins de notes pour le BUT
+
+## Anciennes propositions
+
+Exemples de propositions de formats de bulletins discutées au moment de la
+création de ScoDoc 9.
+
+### Modèle "Lillois"
+
+Proposition de l'IUT de Lille:
+
+- en ligne, les ressources, puis les SAÉ;
+- en colonnes, les UE;
+- dans chaque case, le coefficient et la note obtenue;
+- on peut ajouter les évaluations (lignes);
+- on pourrait ajouter les infos habituelles en colonnes: min/max/moy/rangs/...
+
+Avantage: toutes les informations importantes sont présentées.
+
+Inconvénients (?): beaucoup de cases vides, peu synthétique, pas évident à
+exploiter pour un non spécialiste du BUT (poursuites d'études, employeurs).
+
+<img src="/fig/but-bul-lille.png" width="50%">
+
+### Modèle "Bordelais"
+
+Cette proposition a été reçue sous différentes formes de plusieurs collègues.
+L'idée est de présenter le bulletin en deux parties: d'abord les résultats de
+chaque ressource et SAE, puis les résultats de chaque UE.
+
+Un exemple préliminaire:
+
+<img src="/fig/but-bul-bdx.png" width="50%">

docs/CalculNotes.md

@@ -104,52 +104,29 @@ générale n'est pas définie. Toutefois, ScoDoc calcule une *moyenne indicative
 qui est la moyenne des moyennes des UE du semestre pondérée par leurs ECTS. Voir
 détails [sur la page BUT](BUT.md#moyenne-generale)
 
-## Notes de rattrapage
+## Notes de rattrapage, deuxième session et bonus
 
-Dans chaque module, il est possible de définir une évaluation de "rattrapage".
+Voir la section [modalité d'une évaluation](Evaluation.md#bloquage-et-date-de-prise-en-compte).
-Lors de la création (ou modification) de l'évaluation, indiquer le type
-"Rattrapage":
-
-![CreateEvaluationRat.png](screens/CreateEvaluationRat.png)
-
-Pour chaque étudiant, la note obtenue à l'évaluation de rattrapage remplace la
-moyenne du module, seulement si elle est supérieure à celle-ci.
-
-## Notes de deuxième session
-
-Les notes de l'évaluation de "deuxième session" remplacent, lorsqu'elles sont
-saisies, la moyenne de l'étudiant à ce module, même si la note de deuxième
-session est plus faible.
-
-## Évaluation bonus
-
-On peut aussi définir dans chaque module des évaluations "bonus":
-
-- la valeur est ajoutée à la moyenne du module;</li>
-- le bonus peut être négatif (malus);
-- le bonus ne s'applique pas aux notes de rattrapage et deuxième session;
-- le coefficient est ignoré, mais en BUT le bonus vers une UE est multiplié par
-  le poids correspondant (par défaut égal à 1);
-- les notes de bonus sont prises en compte même si incomplètes.
 
 ## Bonus sport/culture
 
 Ce bonus s'applique directement sur la **moyenne générale** et/ou sur les
 moyennes d'UE (notamment en BUT).
 
-Les notes des UEs de type spécial "Sport & Culture" sont utilisées pour calculer ce bonus.
+Les notes des UEs de type spécial "Sport & Culture" sont utilisées pour calculer
+ce bonus.
 
 Pour qu'un étudiant bénéficie de ce bonus, il doit être inscrit à un module
 d'une UE de type "Sport&Culture". Cette UE et modules associés doivent donc être
 prévu dans le programme pédagogique.
 
-La règle appliquée dépend de l'établissement. Par exemple, l'Université de
+La règle appliquée dépend de l'établissement. Par exemple, l'Université de Haute
-Haute Alsace appliquait le règlement suivant: *Les étudiants de l'IUT peuvent
+Alsace appliquait le règlement suivant: *Les étudiants de l'IUT peuvent suivre
-suivre des enseignements optionnels de l'U.H.A.  (sports, musique, deuxième
+des enseignements optionnels de l'U.H.A.  (sports, musique, deuxième langue,
-langue, culture, etc) non rattachés à une unité d'enseignement. Les points
+culture, etc) non rattachés à une unité d'enseignement. Les points au-dessus de
-au-dessus de 10 sur 20 obtenus dans chacune des matières optionnelles sont
+10 sur 20 obtenus dans chacune des matières optionnelles sont cumulés dans la
-cumulés dans la limite de 10 points. 5% de ces points cumulés s'ajoutent à la
+limite de 10 points. 5% de ces points cumulés s'ajoutent à la moyenne générale
-moyenne générale du semestre déjà obtenue par l'étudiant.*
+du semestre déjà obtenue par l'étudiant.*
 
 L'administrateur peut changer la fonction de calcul du bonus sport via le
 formulaire de configuration accessible (aux admin) depuis la page d'accueil. Si
@@ -197,6 +174,7 @@ n'a pas toute la précision.
 !!! note "Voir aussi"
 
     - [Guide utilisateur](GuideUtilisateur.md)
+    - [Les évaluations](Evaluation.md)
     - [Calculs spécifiques en BUT](BUT.md)
     - [FAQ](FAQ.md)
     - [Contacts](Contact.md)

docs/Evaluation.md

@@ -0,0 +1,79 @@
+# Les évaluations
+
+On appelle dans ScoDoc "évaluation" toute action pédagogique produisant une
+note. Les notes sont des nombres positifs ou nuls (exceptés les "notes" de malus
+qui peuvent être négatives).
+
+## Définition d'une évaluation
+
+- **Description**: texte libre, qui sera affiché sur certains bulletins.
+- **Barème**: note maximale $M$. Les valeurs seront saisies dans l'intervalle $[0, M]$.
+  Les notes affichées sont toujours ramenées sur 20.
+- **Date, heures de début et fin** de la réalisation de l'évaluation. Si les
+  étudiants ne sont pas tous évalués en même temps (exemple: note de TP de
+  différents groupes), on peut ne pas indiquer de date (la possibilité de
+  définir plusieurs dates est à l'étude pour une version future).
+- **Visible sur bulletins**: indique si l'évaluation et la note de l'étudiant doit
+  être affichée sur les bulletins au format dit "intermédiaire" (ni cours, ni
+  long). C'est le format utilisé par la passerelle. La note reste prise en
+  compte dans les moyennes même si l'évaluation n'est pas affichée.
+- **Prise en compte immédiate**: si coché, les notes saisies dans l'évaluation
+  seront prises en compte dans le calcul des moyennes avant même que les notes
+  de tous les étudiants ne soit saisies. Ce réglage peut-être dangereux car les
+  notes sont montrées aux étudiants avant qu'elles soient définitives et devrait
+  rester réservé à des cas particuliers.
+
+## Coefficient et poids
+
+Le coefficient est utilisé pour pondérer les notes de l'évaluation afin de
+calculer la moyenne au module.En BUT, les poids modulent l'importance de
+l'évaluation dans chaque UE. Voir la page [calcul des notes](CalculNotes.md).
+
+## État d'une évaluation
+
+Une évaluation dans laquelle tous les étudiants inscrits au module ont une note
+est dite *complète*. Elle est alors prise en compte dans le calcul des moyennes
+et publiée sur les bulletins (selon les formats et réglages).
+
+Si toutes les notes ne sont pas saisies, l'évaluation est dite *incomplète*, et
+n'est pas prise en compte *sauf* si l'option "Prise en compte immédiate" est
+activée.
+
+Si toutes les notes sont saisies, mais certaines sont "en attente" (`ATT`),
+l'évaluation est dite *en attente*. Elle est prise en compte.
+
+## Modalité d'une évaluation
+
+- **Normale**: produit une note utilisée dans le calcul des moyennes du module.
+- **Rattrapage**: la note d'une évaluation de "rattrapage" remplacera la moyenne
+    du module de l'étudiant *si et seulement si elle est meilleures que celles
+    calculées*.
+- **Deuxième session**: la note remplace, lorsqu'elle est saisie, la moyenne de
+    l'étudiant à ce module, même si sa note de deuxième session est plus faible
+    que sa moyenne normale.
+- **Bonus**: la valeur est ajoutée à la moyenne du module, voir détail ci-dessous.
+
+### Évaluations de "bonus"
+
+Les évaluations bonus sont particulières:
+
+- la valeur est ajoutée à la moyenne du module;
+- le bonus peut être négatif (malus);
+- le bonus ne s'applique pas aux notes de rattrapage et deuxième session;
+- le coefficient est ignoré, mais en BUT le bonus vers une UE est multiplié par le poids correspondant (par défaut égal à 1);
+- les notes de bonus sont prises en compte même si incomplètes.
+
+## Bloquage et date de prise en compte
+
+Ceci permet d'empêcher la prise en compte (et éventuellement la publication) de
+l'évaluation, même si ses notes sont complètes, ou bien de la différer jusqu'à
+la date indiquée.
+
+
+!!! note "Voir aussi"
+
+    - [Les principaux objets de ScoDoc](IntroObjetsScoDoc.md)
+    - [Calcul des notes](CalculNotes.md)
+    - [Les évaluations et le BUT](BUT.md#creer-une-evaluation)
+    - [FAQ](FAQ.md)
+    - [Contacts](Contact.md)

docs/IntroObjetsScoDoc.md

@@ -72,6 +72,7 @@ Les notes sont numériques, mais dans les formations en approche par compétence
 
 Pour en savoir plus:
 
+- [Les évaluations](Evaluation.md)
 - [Calcul des notes](CalculNotes.md)
 - [Bachelor Universitaire de Technologie (BUT)](BUT.md)
 

mkdocs.yml

@@ -42,9 +42,9 @@ nav:
           - "Fin de semestre": TransitionSemestre.md
 
       - "Le BUT":
-          - "Introduction": BUT.md
+          - "Le BUT: introduction": BUT.md
-          - "Exemple complet": BUTExempleInfo.md
+          - "BUT: exemple complet": BUTExempleInfo.md
-          - "Capitalisation UEs": BUTCapitalisationUE.md
+          - "BUT: capitalisation UEs": BUTCapitalisationUE.md
       - "Relations entreprises": RelationsEntreprises.md
       - "Développeurs":
           - "Guide": GuideDeveloppeurs.md