Ajouts divers et réorganisation pages BUT

docs/AssociationScoDoc.md

@@ -1,6 +1,5 @@
 # Association 1901 ScoDoc
 
-
 ScoDoc est un logiciel libre et gratuit, Open Source.
 
 Le développement du projet a été porté par son créateur, Emmanuel Viennet,
@@ -8,26 +7,26 @@ professeur à l'université Sorbonne Paris Nord (ex Paris 13), plusieurs fois ch
 du département Réseaux et Télécommunications de l'IUT de Villetaneuse et
 Président de l'ACD R&T. Plusieurs collègues bénévoles ont contribué, corrigeant
 ou ajoutant des fonctions. Ils sont enseignants ou BIATSS dans les IUT de
-Colmar, Ville d'Avray, Grenoble, Le Havre, Lille, Nantes, pour ne citer que
-ceux-là. 
+Colmar, Ville d'Avray, Grenoble, Le Havre, Lille, Lyon, Mulhouse, Nantes, pour
+ne citer que ceux-là.
 
 Le développement d'un logiciel de cette ampleur prend du temps et demande des
 moyens matériels : serveurs, machines de développement et de test. La
 possibilité de recruter des stagiaires, apprentis ou CDD pour travailler sur le
 projet a souvent été évoquée. Pour se donner ces possibilités et pérenniser le
 projet, nous avons créé début 2020 une association à but non lucratif (loi
-1901). 
+1901).
 
 Les établissements ou départements qui utilisent ScoDoc sont encouragés à
 adhérer à l'association. Leur cotisation permettra de financer les actions de
 l'association et leur permettra d'accéder aux nouvelles fonctionnalités, mise à
-jour et support technique. 
+jour et support technique.
 
 Plusieurs types d'adhésion sont possibles, voir le [bulletin d'adhésion
-PDF](papers/Adhesion-2022-2023-Association-ScoDoc.pdf)  ([version
-Word](papers/Adhesion-2022-2023-Association-ScoDoc.docx)), à renvoyer à
+PDF](papers/Adhesion-2023-2024-Association-ScoDoc.pdf)  ([version
+Word](papers/Adhesion-2023-2024-Association-ScoDoc.docx)), à renvoyer à
 <emmanuel.viennet@gmail.com>. (note: toutes les informations nécessaires à la
 "création fournisseur" sont sur le bulletin d'adhésion).
 
 Nous vous remercions de votre support qui rendra possible la pérennité du projet
-ScoDoc.
+ScoDoc.

docs/BUT.md

@@ -1,4 +1,3 @@
-
 # Le Bachelor Universitaire de Technologie (BUT)
 
 Formation en trois ans dispensées par les IUT français, introduite en 2021, et
@@ -6,9 +5,11 @@ 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. Pour les curieux, la page 
-[modélisation des parcours BUT](ModelisationParcoursBUT.md)
-donne quelques détails sur la façon dont ScoDoc organise les objets du BUT.
+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
+[modélisation des parcours BUT](ModelisationParcoursBUT.md) donne quelques
+détails sur la façon dont ScoDoc organise les objets du BUT.
 
 De nombreux aspects sont aussi décrits dans les
 <a
@@ -18,35 +19,35 @@ style="margin-top:0px; margin-bottom:0px; border-width:0px;"/></a>
 
 ## UE, modules, évaluations
 
- - UE : Unité d'Enseignement, associée à des crédits (ECTS) et validée (ou non)
-   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é à
-   une (seule) UE. 
+- UE : Unité d'Enseignement, associée à des crédits (ECTS) et validée (ou non)
+  en jury. Une UE est rattachée à une *formation*.
 
-   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). 
- 
- - Évaluation: dispositif produisant une note pour les étudiants inscrits à un
-   module. L'évaluation est associée à des coefficients.
+- 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é à
+  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).
+
+- É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:
 
-  - 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: 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..."
 
 Chaque niveau se décompose en deux UE (aka "regroupement cohérent d'UE"), en
 semestres impair et pair d'une année scolaire.
@@ -59,14 +60,15 @@ niveaux) et UEs.
 ## Calcul des notes
 
 Les rôles des SAÉ et ressources étant symétriques, on appellera dans la suite (et
-dans ScoDoc) *module* un objet de type SAÉ _ou_ ressource.
+dans ScoDoc) *module* un objet de type SAÉ *ou* ressource.
 
 Dans la suite, on considère les poids et coefficients toujours positifs ou
 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*). 
+localement*).
 
 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
@@ -97,20 +99,20 @@ 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
 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. 
+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: 
+vers l'UE $u$. La somme des notes d'un module pour l'UE $u$ est:
 
 $$n_u = \sum_e p_{e,u} \, n_e$$
 
 Chaque UE indiquée par le référentiel de formation doit être évaluée: si le
-coefficient du module vers l'UE $u$ est non nul, la somme des poids vers 
+coefficient du module vers l'UE $u$ est non nul, la somme des poids vers
 une UE $u$ *doit* être non nulle; si ce n'est pas le cas, le module sera déclaré
-*non conforme* et le jury ne pourra pas être tenu. 
-
+*non conforme* et le jury ne pourra pas être tenu.
 
 ### Moyenne de module (SAÉ ou ressource)
+
 La moyenne d'un étudiant dans un module est un vecteur, car on a une note moyenne par UE:
 
 $$\mu_{m, u} = \frac{\sum_e p_{e,u} \, n_e}{\sum_{e} \, p_{u,e}}$$
@@ -135,6 +137,7 @@ 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.
 
 ### Validation d'une UE
+
 La validation ou non d'une UE dépend uniquement de la moyenne générale (et des
 conditions habituelles d'assiduité et de défaillance spécifiées dans les
 règlements des établissements):
@@ -171,6 +174,7 @@ 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.
 
 ### Passage d'une année à l'autre
+
 Les conditions de passages vers l'année suivante sont:
 
  1. Moyenne supérieure ou égale à 10/20 obtenue à plus de de la moitié des
@@ -184,15 +188,16 @@ Note: La validation des deux UE du niveau d’une compétence emporte la validat
  l’ensemble des UE du niveau inférieur de cette même compétence.
 
 ### Redoublements
+
 La poursuite d'études dans un semestre pair d’une même année est *de droit* pour
 tout étudiant. La poursuite d’études dans un semestre impair est possible si et
 seulement si l’étudiant a obtenu :
 
- - la moyenne à plus de la moitié des regroupements cohérents d’UE ;
- - et une moyenne égale ou supérieure à 8 sur 20 à chaque regroupement cohérent
+- la moyenne à plus de la moitié des regroupements cohérents d’UE ;
+- et une moyenne égale ou supérieure à 8 sur 20 à chaque regroupement cohérent
 d’UE. La poursuite d'études dans le semestre 5 nécessite de plus la validation
 de toutes les UE des semestres 1 et 2 dans les conditions de validation des
-points 4.3 et 4.4, ou par décision de jury. 
+points 4.3 et 4.4, ou par décision de jury.
 
 Durant la totalité du cursus conduisant au bachelor universitaire de
 technologie, l'étudiant peut être autorisé à redoubler une seule fois chaque
@@ -202,12 +207,11 @@ appréciée par ses soins. Tout refus d'autorisation de redoubler est pris aprè
 avoir entendu l'étudiant à sa demande. Il doit être motivé et assorti de
 conseils d'orientation.
 
-
 ### Obtention du diplôme
 
 Le diplôme de BUT est obtenu lorsque toutes les compétences du parcours suivi
 sont validées.
- 
+
 ### Modules "bonus" (sport, culture, LV2)
 
 Les modules hors formation comme le sport ou les langues vivantes supplémentaires
@@ -221,7 +225,7 @@ Les règles précises du calcul de ce bonus sont malheureusement variables d'un
 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.
 
-# Éditer ou importer une formation
+## Éditer ou importer une formation
 
 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
@@ -229,21 +233,22 @@ locale*.
 
 TODO: voir si on offre la possibilité de voir/gérer le delta entre le PN et le local.
 
-# Modules et évaluations
+## Modules et évaluations
 
-## Créer une évaluation
+### Créer une évaluation
 
 Pour fixer les poids des évaluations du module, on peut employer plusieurs méthodes:
 
- - un nombre (poids de l'évaluation dans le module, sans préciser si cette
-   évaluation affecte plus un UE qu'une autre);
+- 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);
+- 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.
+- indiquer un poids par UE.
 
 #### Coefficient et poids d'une évaluation
+
 Afin de faciliter la tâche des enseignants, ScoDoc sépare le coefficient d'une
 évaluation (qui donne sa place dans le module) et les poids (qui ajustent son
 impact dans chaque UE). On introduit donc un coefficient $w_e$, et les poids
@@ -255,21 +260,19 @@ $$p_{e, u} =  w_e \, \frac{b_{e,u}}{\sum_u b_{e,u}}$$
 
 <img src="/fig/but-dialog-eval-create.png" width="50%">
 
-  - L'enseignant _doit_ renseigner le coefficient de l'évaluation. 
-  - Par défaut, les poids valent 1 (la contribution de l'évaluation vers les
-    différentes UE respecte alors le PN).
-  - Si on décoche un AC, les poids sont mis à jour, au prorata du nombre d'AC
-    dans chaque UE (compétence).
-  
-
+- L'enseignant *doit* renseigner le coefficient de l'évaluation.
+- Par défaut, les poids valent 1 (la contribution de l'évaluation vers les
+  différentes UE respecte alors le PN).
+- Si on décoche un AC, les poids sont mis à jour, au prorata du nombre d'AC
+  dans chaque UE (compétence).
 
 ## 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)
+- 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
+- Poids de chaque évaluation dans chaque UE et conformité au programme de la formation
 
 En bas du tableau de bord du module on aura un tableau récapitulatif:
 
@@ -280,20 +283,19 @@ des poids ou oubli d'une évaluation):
 
 <img src="/fig/but-tableau-evals-module-ko.png" width="50%">
 
-
-
-# Bulletins de notes
+## Bulletins de notes
 
 La quantité d'information à présenter rend la conception des bulletins de notes difficile.
 
-## Modèle "Lillois"
+### 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/...
+- 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.
 
@@ -302,7 +304,8 @@ exploiter pour un non spécialiste du BUT (poursuites d'études, employeurs).
 
 <img src="/fig/but-bul-lille.png" width="50%">
 
-## Modèle "Bordelais"
+### 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.
@@ -311,25 +314,22 @@ Un exemple préliminaire:
 
 <img src="/fig/but-bul-bdx.png" width="50%">
 
-
-
-# Tenue des Jury BUT
+## Tenue des Jury BUT
 
 La tenue des jury BUT dans ScoDoc est très similaire à celle du DUT, avec moins
 de décisions ad-hoc (compensations plus simples, moins de cas de mise en attente).
 
-  - Validation des semestres (bien que cela ait peu de conséquences concrètes
-    pour les semestres impairs.
-  
-  - Règles de compensation au sein de chaque niveau, pour validation de l'année. 
+- Validation des semestres (bien que cela ait peu de conséquences concrètes
+  pour les semestres impairs.
 
+- Règles de compensation au sein de chaque niveau, pour validation de l'année. 
 
 !!! note "Voir aussi"
 
+    - [Modélisation BUT: exemple de la spécialité Informatique](BUTExempleInfo.md)
     - [Guide utilisateur](GuideUtilisateur.md)
     - [Guide du responsable de formation](GuideAdminFormation.md)
     - [Tutoriels vidéo](https://www.youtube.com/channel/UCb0JYCBRi0CsE4XFp4ByhXg)
     - [FAQ](FAQ.md)
+    - [Développeurs: Implémentation des parcours du BUT](ModelisationParcoursBUT.md)
     - [Contacts](Contact.md)
-
-

docs/BUTCapitalisationUE.md

@@ -0,0 +1,35 @@
+# Exemple BUT avec UE capitalisée
+
+Soit une formation BUT, ici R&T, avec 3 UE. Certaines ressources (comme R101) sont communes à
+deux ou trois UEs.
+
+<img src="/fig/but-uescap-coefs.png" width="25%">
+
+L'étudiant "Mael REDOUBLE" a redoublé sa première année, mais avait capitalisé
+l'UE 1 de S1. Son parcours s'affiche ainsi:
+
+<img src="/fig/but-uescap-fiche.png" width="60%">
+
+Son bulletin montre l'UE 1 actuelle (moyenne 8,32/20) et celle capitalisée
+(moyenne 10,36/20):
+<img src="/fig/but-uescap-bul-avant.png" width="70%">
+
+Il décide de ne pas refaire cette UE1. Pour cela, on le désinscrit de l'UE (menu
+**Inscriptions** / **Gérer les inscriptions aux UEs et modules**).
+
+<img src="/fig/but-uescap-desincr.png" width="40%">
+
+Maintenant, son UE1 capitalisée apparait seule sur son bulletin.
+
+Dans cet exemple, la ressource `R101` (commune) est rattachée à l'UE 1 (mais ce
+rattachement technique n'a pas de conséquences pratiques). L'étudiant reste bien
+sûr inscrit à `R101` (et doit suivre ses cours), puisque cette ressource
+intervient dans les autres UE non capitalisées.
+
+S'il y a des ressources dont les notes ne contribuent qu'à l'UE1, l'étudiant
+peut ne pas les suivre: il faut alors le désincrire sélectivement au niveau du
+tableau de bord module.
+
+C'est dans cet exemple le cas pour la SAÉ `SAE11`.
+
+<img src="/fig/but-uescap-inscrmodule.png" width="30%">

docs/BUTExempleInfo.md

@@ -162,10 +162,13 @@ deux versions de la ressources (par exemple `R4.01-A`et `R4.01-B`).
 ## Mise en place des semestres
 
 La création des semestres ne présentent aucune particularité dans ce cas. Il
-faut juste indiquer les par proposés dans le semestre. Dans notre exemple:
+faut juste indiquer les parcours proposés dans le semestre. Dans notre exemple:
 
 <img src="/screens/but-info-sem-parcours-A-B.png" width="50%">
 
+Remarque: si la spécialité n'a que des compétences communes dans ce semestre
+(tronc commun, fréquent en BUT1), *ne pas cocher de parcours*.
+
 ## Affectation des étudiants aux parcours
 
 Nous supposons dans la suite que nous avons les deux parcours A et B dans notre
@@ -194,6 +197,7 @@ Dans chaque module, on peut régler les inscriptions:
 
 !!! note "Voir aussi"
 
+    - [Le BUT: détails et calculs](BUT.md)
     - [Guide du responsable de formation](GuideAdminFormation/md)
     - [Édition des programmes de formation](VersionProgrammes.md)
     - [Guide utilisateur](GuideUtilisateur.md)

docs/GuideUtilisateur.md

@@ -44,7 +44,7 @@ département.
 
 ### Spécificités du BUT
 
-(documentation à venir)
+* Voir [la page dédiée au BUT](BUT.md).
 
 ### Spécificités du DUT
 

mkdocs.yml

@@ -27,7 +27,10 @@ nav:
       - "Guide utilisateur": GuideUtilisateur.md
       - "Tutos vidéos": https://www.youtube.com/playlist?list=PLw49h6RbvswhasBk9bXj7PzOD8GDW3kG1
       - "Responsables de formations": GuideAdminFormation.md
-      - "Le BUT": BUT.md
+      - "Le BUT":
+          - "Introduction": BUT.md
+          - "Exemple complet": BUTExempleInfo.md
+          - "Capitalisation": BUTCapitalisationUE.md
       - "Relations entreprises": RelationsEntreprises.md
       - "FAQ": FAQ.md