diff --git a/README.md b/README.md
index 83ab45aa6..ae79e0978 100644
--- a/README.md
+++ b/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
+-
\ No newline at end of file
diff --git a/docs/BUT.md b/docs/BUT.md
index 9687c65df..f19921618 100644
--- a/docs/BUT.md
+++ b/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
-basée sur une forme d'approche par compétences nécessitant un système
-d'évaluation spécifique.
+Le BUT est une formation en trois ans dispensées par les IUT français,
+introduite en 2021, et basée sur une forme d'approche par compétences
+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é
-Informatique](BUTExempleInfo.md). Pour les curieux et les développeurs, la page
+semestres d'un BUT ici:
+[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;"/>
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
- SAE (*situation d'apprentissage et d'évaluation*). Un module est rattaché à
+ 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é à
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
- - Niveau
- - Composantes essentielles ("En respectant les règles métiers...")
- - Situations professionnelles ("Surveillance de la qualité de la
- production...")
+- **Compétence**
+ - Niveau
+ - Composantes essentielles ("En respectant les règles métiers...")
+ - Situations professionnelles ("Surveillance de la qualité de la
+ production...")
-- Niveaux de compétence: associés à une année. Attention, le niveau 1 commence
- parfois en deuxième année.
- - Numéro (1, 2, 3)
- - Titre
- - Apprentissages critiques (AC): "Identifier les dysfonctionnements du réseau local..."
+- **Niveaux de compétence**: la compétence est divisée en niveaux, associés à
+ une année de la formation. Le premier niveau 1 commence souvent en première
+ année (BUT1), mais parfois en deuxième année (BUT2). Le niveau est défini par
+ - Numéro (1, 2, 3)
+ - 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é
-localement*).
+Les coefficients des modules (ressources et SAÉ) sont fixés par le programme de
+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
-module $m$ dans l'UE $u$, la moyenne d'UE de l'étudiant est
+évaluations) représentée par le nombre $\mu_m$. Si $c_{u,m}$ désigne le
+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
-ScoDoc conçues avant le BUT):
+titre indicatif (mais n'est pas présentée aux étudiants dans les bulletins pour
+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:
-Par ailleurs, il est (parfois, peut-être) utile de calculer des moyennes par
-pôles au sein de l'UE: pôle SAÉ, pôle ressource.
+Dans ScoDoc, on va éditer les coefficients des modules sur cette page
+
+
+(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
-obtenues (avec moyenne > 10/20) s'il arrête temporairement ses études ou redouble un semestre.
+Dans le BUT comme dans toutes les formations LMD, les UEs sont capitalisables,
+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
-résultat antérieur sauf s'il obtient une meilleure moyenne.
+En cas de redoublement, l'étudiant qui choisi de répéter une UE capitalisée
+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
-regroupement d'UE est considéré indépendamment (aucunes compensations entre UE
-relevant de compétences différentes).
+La validation du BUT ne considère pas de "moyenne générale": chaque regroupement
+d'UE est considéré indépendamment (aucune compensations entre UEs relevant de
+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.
+
+
+
### 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
-situation sera identique avec le BUT et ScoDoc 9, et la mise en place d'une
-fonction spécifique dans ScoDoc demandera un paramétrage particulier: voir [la
-page sur les bonus et malus](BonusMalus.md).
+établissement à l'autre: ScoDoc 9 propose actuellement (mars 2024)
+quarante-trois (43, vous avez bien lu) modes de calculs différents. La mise en
+place d'une fonction spécifique dans ScoDoc demande un paramétrage particulier:
+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
-applications, comme Orébut, puis de les modifier pour introduire une *adaptation
-locale*.
+ScoDoc permet de créer et éditer un programme de formation, et d'exporter ou
+importer des formations dans un format d'échange XML.
-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:
-
-- Vérification de la conformité (tous les AC cochés dans le PN sont évalués)
+Fonctions spécifiques au BUT:
- 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:
@@ -284,43 +316,30 @@ des poids ou oubli d'une évaluation):
+
## 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É;
-- 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).
-
-
-
-### 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:
-
-
+Voir quelques propositions, sources d'inspiration pour les formats proposés par
+ScoDoc 9 [sur cette page](BUTBulletins.md)
## Tenue des Jury BUT
-La tenue des jury BUT dans ScoDoc est en fait plus simple que celle des anciens DUTs, avec moins
-de décisions ad-hoc (compensations plus simples, moins de cas de mise en
-attente). Comme pour les formations LMD, il s'agit avant tout de constater ou
-valider manuellement les Unités d'Enseignements (UEs) associées à des ECTS.
+La tenue des jury BUT dans ScoDoc est en fait plus simple que celle des anciens
+DUTs, avec moins de décisions ad-hoc (compensations plus simples, moins de cas
+de mise en attente). Comme pour les formations LMD, il s'agit avant tout de
+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)
diff --git a/docs/BUTBulletins.md b/docs/BUTBulletins.md
new file mode 100644
index 000000000..07ddc1ded
--- /dev/null
+++ b/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).
+
+
+
+### 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:
+
+
diff --git a/docs/CalculNotes.md b/docs/CalculNotes.md
index 0dcab382b..79db20c45 100644
--- a/docs/CalculNotes.md
+++ b/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".
-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;
-- 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.
+Voir la section [modalité d'une évaluation](Evaluation.md#bloquage-et-date-de-prise-en-compte).
## 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
-Haute Alsace appliquait le règlement suivant: *Les étudiants de l'IUT peuvent
-suivre des enseignements optionnels de l'U.H.A. (sports, musique, deuxième
-langue, culture, etc) non rattachés à une unité d'enseignement. Les points
-au-dessus de 10 sur 20 obtenus dans chacune des matières optionnelles sont
-cumulés dans la limite de 10 points. 5% de ces points cumulés s'ajoutent à la
-moyenne générale du semestre déjà obtenue par l'étudiant.*
+La règle appliquée dépend de l'établissement. Par exemple, l'Université de Haute
+Alsace appliquait le règlement suivant: *Les étudiants de l'IUT peuvent suivre
+des enseignements optionnels de l'U.H.A. (sports, musique, deuxième langue,
+culture, etc) non rattachés à une unité d'enseignement. Les points au-dessus de
+10 sur 20 obtenus dans chacune des matières optionnelles sont cumulés dans la
+limite de 10 points. 5% de ces points cumulés s'ajoutent à la moyenne générale
+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)
diff --git a/docs/Evaluation.md b/docs/Evaluation.md
new file mode 100644
index 000000000..ee8d35dc8
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/docs/IntroObjetsScoDoc.md b/docs/IntroObjetsScoDoc.md
index b12c3f39f..d999f7da6 100644
--- a/docs/IntroObjetsScoDoc.md
+++ b/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)
diff --git a/docs/screens/but-option-moy-indicative.png b/docs/screens/but-option-moy-indicative.png
new file mode 100644
index 000000000..33cd8f8e7
Binary files /dev/null and b/docs/screens/but-option-moy-indicative.png differ
diff --git a/mkdocs.yml b/mkdocs.yml
index 82231d558..0715533e6 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -42,9 +42,9 @@ nav:
- "Fin de semestre": TransitionSemestre.md
- "Le BUT":
- - "Introduction": BUT.md
- - "Exemple complet": BUTExempleInfo.md
- - "Capitalisation UEs": BUTCapitalisationUE.md
+ - "Le BUT: introduction": BUT.md
+ - "BUT: exemple complet": BUTExempleInfo.md
+ - "BUT: capitalisation UEs": BUTCapitalisationUE.md
- "Relations entreprises": RelationsEntreprises.md
- "Développeurs":
- "Guide": GuideDeveloppeurs.md