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). 
-* `civilite_etat_civil` est associé au prénom d'état-civil (donc jamais utilisé si `prenom_etat_civil` n'est pas renseigné. 
+* `prenom_etat_civil`: Si présent, indique le prénom qui doit être utilisé dans
+  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 
-  sauf dans les documents officiels (procès-verbal et bulletin de notes). Ce changement peut être accompagné d'un changement de 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.
+  Ce prénom, qui ne demande pas d'acte officiel (hormis une demande formelle à
+  l'université d'appartenance) remplace le prénom initial dans tous les
+  documents internes sauf dans les documents officiels (procès-verbal et
+  bulletin de notes). Ce changement peut être accompagné d'un changement de
+  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.
-* Par la procédure d'importation par tableur (`Import/export des données d'admission` du menu `INSCRIPTIONS`)
+* Dans l'écran `Changer les données identité/admission` du menu `Étudiant` dans
+  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
-* 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
-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)).
+* 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 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 `json` et `pdf` (`json` par défaut, ajoutez `/pdf` pour la version
+  * version `long` (défaut), `short` (sans évaluations), `selectedevals` (avec
+    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
-  non indiquer les matières. Par défaut (version `long`), il est structuré en
-  `UEs / modules`.
-  Si la version est `short_mat`ou `long_mat`, il sera structuré en
-  `UEs / matieres / modules`.
+  (*à vérifier*) Pour les formations classiques (toutes sauf BUT), les bulletins
+  JSON peuvent ou non indiquer les matières. Par défaut (version `long`), il est
+  structuré en `UEs / 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*"). `