Précisions sur gestion civilité étudiant

docs/DonneesEtudiant.md

@@ -2,49 +2,63 @@
 
 ## Description d'un étudiant
 
-La désignation d'un étudiant (classiquement civilité-nom-prenom) peut prendre différentes formes en fonctions des circonstances et des souhaits de l'étudiant.
+La désignation d'un étudiant (classiquement civilité-nom-prénom) peut prendre
+différentes formes en fonctions des circonstances et des souhaits de l'étudiant.
 On distingue les éléments suivants:
 
-* `nom`: (obligatoire): le nom de l'étudiant (en usage dans l'établissement). Généralement (mais pas toujours) le nom d'état-civil de l'étudiant.
+* `nom`: (obligatoire): le nom de l'étudiant (en usage dans l'établissement).
+  Généralement (mais pas toujours) le nom d'état-civil de l'étudiant.
 * `prenom`:  (obligatoire): le prénom de l'étudiant
 * `civilité`:  (obligatoire): la civilité utilisée parmi les valeurs:
   * `MR` (ou aussi `H` ou `M`)
   * `MME` (ou aussi `F`)
   * `X` décrit plus loin
 * `nom_usuel`: si présent s'affiche à la place du `nom`.
-* `prenom_etat_civil`: Si présent, indique le prénom qui doit être utilisé dans les documents officiels (PV et bulletin). 
+* `prenom_etat_civil`: Si présent, indique le prénom qui doit être utilisé dans
-* `civilite_etat_civil` est associé au prénom d'état-civil (donc jamais utilisé si `prenom_etat_civil` n'est pas renseigné. 
+  les documents officiels (PV et bulletin).
+* `civilite_etat_civil` est associé au prénom d'état-civil (donc jamais utilisé
+  si `prenom_etat_civil` n'est pas renseigné).
 
-## Personalisations
+## Personnalisations
 
 L'étudiant peut:
 
 * déclarer un nom d'usage qui remplacera le nom initial dans tous les documents
   (par exemple par l'adoption d'un nom marital pour remplacer le patronyme)
   Il faut dans ce cas remplir la donnée `nom_usuel` avec le nouveau nom souhaité.
-* Demander la suppression de la civilité courante (`MR` ou `MME`). La valeur `X` peut être utlisée dans ce cas.
+* Demander à ce que sa civilité (`M.` ou `Mme`) ne soit pas affichée. La valeur
+  `X` doit être utilisée dans ce cas.
 * demander l'utilisation d'un prénom d'usage ([1] et [2]).
   
-  Ce prénom, qui ne demande pas d'acte officiel (hormis une demande formelle à l'université d'appartenence) remplace le prénom initial dans tous les documents internes 
+  Ce prénom, qui ne demande pas d'acte officiel (hormis une demande formelle à
-  sauf dans les documents officiels (procès-verbal et bulletin de notes). Ce changement peut être accompagné d'un changement de civilité.
+  l'université d'appartenance) remplace le prénom initial dans tous les
-  Il faut dans ce cas:
+  documents internes sauf dans les documents officiels (procès-verbal et
-  * Reporter le prénom et la civilité initiaux dans les champs `prenom_etat_civil` et `civilite_etat_civil`
+  bulletin de notes). Ce changement peut être accompagné d'un changement de
-  * Remplacer les champs `civilite` et `prenom` avec les valeurs souhaitées par l'étudiant.
+  civilité. Il faut dans ce cas:
+  * Reporter le prénom et la civilité initiaux dans les champs
+    `prenom_etat_civil` et `civilite_etat_civil`
+  * Remplacer les champs `civilite` et `prenom` avec les valeurs souhaitées par
+    l'étudiant.
 
 ## Dans le logiciel
 
 Les données personnelles sont modifiables:
 
-* Dans l'écran `Changer les données identité/admission` du menu `Étudiant` dans la fiche étudiant.
+* Dans l'écran `Changer les données identité/admission` du menu `Étudiant` dans
-* Par la procédure d'importation par tableur (`Import/export des données d'admission` du menu `INSCRIPTIONS`)
+  la fiche étudiant.
+* Par la procédure d'importation par tableur (`Import/export des données
+  d'admission` du menu `INSCRIPTIONS`)
 
 Les civilités et prénom d'état-civil sont prises en compte:
 
-* Automatiquement lors de la production du procés-verbal
+* Automatiquement lors de la production du procès-verbal
-* Dans l'édition du bulletin au format pdf (pas sur la passerelle étudiant) à condition que les descriptions spécifiées dans le paramètrage du département et/ou les réglages bulletin des semestres concernés mentionne
+* Dans l'édition du bulletin au format pdf (pas sur la passerelle étudiant) à
-la balise `etat_civil` plutôt que la balise `nomprenom` (cf. [Paramètrage des bulletins / Valeurs remùplacées](https://scodoc.org/ParametrageBulletins/#valeurs-remplacees)).
+condition que les descriptions spécifiées dans le paramétrage du département
+et/ou les réglages bulletin des semestres concernés mentionne la balise
+`etat_civil` plutôt que la balise `nomprenom` (voir
+[Paramétrage des bulletins / Valeurs remplacées](https://scodoc.org/ParametrageBulletins/#valeurs-remplacees)).
 
-Les données personalisées figurent toutes dans les données livrées par l'API.
+Les données personnalisées figurent toutes dans les données livrées par l'API.
 
 ## Références
 

docs/ScoDoc9API.md

@@ -1308,17 +1308,18 @@ mais pas JSON compliant à cause des `NaN`.
 
 * **Exemple d'utilisation:** `/etudiant/nip/1/formsemestre/1/bulletin`
 * **Résultat:** Bulletin de l'étudiant dans le formsemestre.
-  Deux variantes possibles:
+  Plusieurs variantes possibles:
 
-  * versions `long` et `short` (`long` par défaut, ajoutez `/short` pour la version plus courte).
+  * version `long` (défaut), `short` (sans évaluations), `selectedevals` (avec
-  * version `json` et `pdf` (`json` par défaut, ajoutez `/pdf` pour la version
+    seulement les évaluations "visibles en format intermédiaire"), `butcourt`
+    (format court spécial BUT, disponible en format PDF seulement).
+  * format `json` ou `pdf` (`json` par défaut, ajoutez `/pdf` pour la version
     pdf)
   
-  Pour les formations classiques (toutes sauf BUT), les bulletins JSON peut ou
+  (*à vérifier*) Pour les formations classiques (toutes sauf BUT), les bulletins
-  non indiquer les matières. Par défaut (version `long`), il est structuré en
+  JSON peuvent ou non indiquer les matières. Par défaut (version `long`), il est
-  `UEs / modules`.
+  structuré en `UEs / modules`.
-  Si la version est `short_mat`ou `long_mat`, il sera structuré en
+  
-  `UEs / matieres / modules`.
   Les notes moyennes de matières ne sont calculées que si l'option
   "*Afficher les matières sur les bulletins*" est activée pour le formsemestre
   considéré (sinon, la note vaut toujours "*nd*"). `