début de mise à jour de la liste des champs

docs/ApiGenerationBulletinsPdf.md

@@ -1,22 +1,26 @@
-#  Générer des bulletins en Python
+# Génération des bulletins en Python
 
-Il est possible de coder de nouveaux styles de bulletins de notes (web et/ou
-PDF), pour répondre précisément aux besoins de votre établissement.
+Informations internes à destination des développeurs.
 
-Ce n'est pas très difficile, mais il faudra coder en langage Python avec pour le
-PDF la bibliothèque ReportLab (qui est bien documentée, [voir le
-guide](http://www.reportlab.com/software/opensource/rl-toolkit/guide/)).
+## Types de bulletins
 
-ScoDoc demande la création d'un bulletin pour un étudiant donné dans semestre
-donné (`formsemestre_id`). Le bulletin doit être rendu sous forme d'une liste
-d'objets PLATYPUS (voir le chapitre 5 du "User Guide" de ReportLab cité plus
-haut).
+- Formations classiques
+  - HTML, court, intermédiaire, long
+  - XML (deprecated)
+  - JSON
+  - PDF
+- Formations BUT
+  - JSON (utilisé par la version HTML)
+  - XML (partiel, deprecated)
+  - PDF
+  - "but court" HTML
+  - "but court" PDF
 
-<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
-alt="/!\" /> Attention (août 2011): nouvelle version, changement d'API: les
-informations ci-dessous s'appliquent à partir de la subversion 1047.
+## Balises décisions de jury pour chaque type
 
-##  Organisation
+
+
+## Organisation
 
 A minima, il vous faut créer un module python (fichier .py) qui se définira une
 classe chargée de générer vos bulletins.
@@ -193,7 +197,6 @@ Type | Nom | Description | Exemple de valeur
  | decision | Décision du jury d'admission | 'ADMIS'
  | description | Comment l'étudiant a été inscrit | '(creation individuelle)'
 
-
 #### Inscription
 
  Type | Nom | Description | Exemple de valeur
@@ -220,7 +223,8 @@ Type | Nom | Description | Exemple de valeur
   string  | refcomp_specialite     | code spécialité   | "RT"
   string  | refcomp_specialite_long| spécialité        | "Réseaux et Télécommunications"
 
-###  Résultats (notes) de l'étudiant dans le semestre 
+### Résultats (notes) de l'étudiant dans le semestre
+
 Quelques infos sur les résultats. Le détail des notes est dans la
 liste `infos['ues']` et ses sous-listes imbriquées (modules, evaluation).
 

docs/BonusMalus.md

@@ -46,8 +46,8 @@ inférieure à zéro), elle est ramenée à 20 (ou à zéro).
 
 - La valeur saisie peut être négative (et donnera alors un bonus);
     l'affichage est mis à jour en conséquence. C'est donc la possibilité
-    d'inclure un bonus donc la valeur n'est pas calculée par la formule
-    configurée (cf. [Intégration de la formule](#intégration-de-la-formule)).
+    d'inclure un bonus dont la valeur n'est pas calculée par la formule
+    configurée (cf. [Intégration de la règle de calcul](#integration-de-la-regle-de-calcul)).
 
 ## Comparatif bonus/malus
 
@@ -59,7 +59,7 @@ les modules de malus.
 | **Structure**                        | UE Spécifique et modules (type standard) attachés | Module spécifique (type malus)             |
 | **Valeur du bonus/malus**            | Calculé à partir d'une note                       | Saisie directe                             |
 | **Application sur toutes les UE**    | Automatique                                       | Autant de modules que d'UE modifiées       |
-| **Application sur une seule UE**     | Impossible                                        | Un module par UE modifiée                  |                                   |
+| **Application sur une seule UE**     | Impossible                                        | Un module par UE modifiée                  |
 | **Modification**                     | Bonus seulement                                   | Malus ou Bonus                             |
 | **Affichage**                        | Affichage du bonus et du détail                   | Affichage du bonus/malus seulement         |
 | **Cumul de plusieurs modificateurs** | voir [les remarques](#remarques)                  | Déclarer une évaluation par type de modif. |
@@ -88,7 +88,7 @@ Si l'établissement n'apparaît pas:
    modificateur (après un calcul préalable hors scodoc)
 
 2. Vous pouvez demander la création de la formule spécifique à votre
-   établissement sur le serveur discord en précisant:
+   établissement sur le serveur Discord (voir [contacts](Contact.md)) en précisant:
     - Le nom de votre établissement,
     - l'extrait du règlement intérieur qui décrit cette bonification, (celui ci
       apparaîtra dans l'encadré explicatif)

docs/FAQ.md

@@ -119,6 +119,16 @@ Les ECTS sont attribués (ou pas) au moment de la saisie de la décision de jury
 sur les UEs. Avant le jury, l'étudiant n'a jamais d'ECTS, quelles que soient ses
 notes.
 
+### Comment identifier les ECTS ?
+
+Les ECTS sont toujours liés aux Unités d'Enseignement (UE). Toute validation
+d'UE apporte à l'étudiant son quota d'ECTS. Cette quantité est définie dans le
+programme de la formation.
+
+Les UEs peuvent être validées par le jury d'un semestre: le compte est affiché
+sur une colonne à droite du tableau **Jury / Voir les décisions de jury**.
+
+
 
 ### L'étudiant n'est pas diplômé
 
@@ -126,6 +136,17 @@ Vérifiez qu'il a bien obtenu tous ces ECTS.
 Si ce n'est pas le cas, vérifiez qu'il a bien validé toutes les UEs de son
 parcours de formation (BUT), ou un nombre suffisant de celles ci.
 
+### Comment voir toutes les validations de jury d'un étudiant ?
+
+Dans certains cas, on souhaite vérifier tout le détail des validations de jury
+enregistrées pour un étudiant. Pour cela, aller sur sa fiche et suivre le lien
+*Éditer toutes décisions de jury*. Vous aurez le détail de tous les éléments
+validés (UE, RCUEs du BUT, semestres des formations LMD, années du BUT, ...) et
+pourrez même les supprimer une à une (si vous disposez des droits d'accès nécessaires.)
+
+Voir aussi [guide du responsable de formation](GuideAdminFormation.md#jurys)
+et [les jurys de BUT](BUTJurys.md).
+
 ## Administration système
 
 ### Mes données sont erronées, que faire ?

docs/ScoDoc9API.md

@@ -1341,7 +1341,7 @@ utilisateur pourra être associé à un ou plusieurs rôles dans chaque départe
 (ainsi, il ou elle peut enseigner dans un département et être administrateur
 d'un autre).
 
-#### **roles**
+#### **list-roles**
 
 * **Méthode:** GET
 * **Permission: `UsersView`**
@@ -1350,7 +1350,7 @@ d'un autre).
 * **Résultat:** Liste de tous les rôles.
 * **Exemple de résultat:** [roles.json](samples/sample_roles.json.md)
 
-#### **role**
+#### **list-role**
 
 * **Méthode:** GET
 * **Permission: `UsersView`**
@@ -1359,7 +1359,7 @@ d'un autre).
 * **Résultat:** Liste le rôle indiqué. 404 si inexistant.
 * **Exemple de résultat:** [role.json](samples/sample_role.json.md)
 
-#### **role-add_permission**
+#### **role-permission-add**
 
 * **Méthode: POST**
 * **Permission: `ScoSuperAdmin`**
@@ -1369,7 +1369,7 @@ d'un autre).
   Note: la liste des permissions est donnée sur [ConfigPermissions](ConfigPermissions.md).
 * **Exemple de résultat:** [role-add_permission.json](samples/sample_role-add_permission.json.md)
 
-#### **role-remove_permission**
+#### **role-permission-remove**
 
 * **Méthode: POST**
 * **Permission: `ScoSuperAdmin`**
@@ -1416,7 +1416,7 @@ d'un autre).
 
 ### **API User, Permissions**
 
-#### **user**
+#### **user-info**
 
 * **Méthode:** GET
 * **Permission: `UsersView`**
@@ -1448,7 +1448,7 @@ d'un autre).
   si est "super-administrateur".
 * **Exemple de résultat:** [user-create.json](samples/sample_user-create.json.md)
 
-#### **`users-query`**
+#### **`users-info-query`**
 
 * **Méthode:** GET
 * **Permission: `UsersView`**
@@ -1521,7 +1521,7 @@ d'un autre).
 * **Résultat:** Retire le rôle à l'utilisateur.
 * **Exemple de résultat:** [user-role-remove.json](samples/sample_user-role-remove.json.md)
 
-#### **`permissions`**
+#### **`list-permissions`**
 
 * **Méthode:** GET
 * **Permission: `UsersView`**