modif page API

docs/BUT.md

@@ -43,7 +43,7 @@ niveaux) et UEs.
 
 ## Calcul des notes
 
-Les rôles des SAÉ et ressources étant symétriques, on appellera dans al suite (et
+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 la suite, on considère les poids et coefficients toujours positifs ou
@@ -80,7 +80,7 @@ réduit d'apprentissages critiques:
 
 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
+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. 
 
@@ -96,7 +96,7 @@ une UE $u$ *doit* être non nulle; si ce n'est pas le cas, le module sera décla
 
 
 ### Moyenne de module (SAÉ ou ressource)
-La moyenne d'un module est un vecteur, car on a une note moyenne par UE:
+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}}$$
 
@@ -110,7 +110,7 @@ $$\mu_m = \frac{\sum_e (\sum_u p_{e,u}) \, n_e}{\sum_{u,e} \, p_{u,e}}$$
 
 On va considérer les coefficients de modules et d'évaluations:
 
-$$\mu_u = \frac{1}{\sum_m c_{u,m}} \, \sum_{m \in u} c_{u,m} \, \frac{\sum_e p_{e,u} \, n_e}{\sum_{e} \, p_{u,e}}$$
+$$\mu_u = \frac{1}{\sum_m c_{u,m}} \, \sum_{m \in u} c_{u,m} \, \frac{\sum_e p_{e,u} \, n_e}{\sum_{e} \, p_{e,u}}$$
 
 L'exemple suivant illustre ce mode de calcul:
 

docs/GuideAdminSys.md

@@ -34,7 +34,7 @@ référer à [GuideInstallDebianDix](GuideInstallDebianDix.md) ou
 ##  Utilisation avancée
 
  * [Interfaçage avec Apogée](ScoDocApogee.md)
- * [API](ScoDocAPI.md) : API JSON ou XML pour interfaçage avec d'autres applications
+ * [API](ScoDoc9API.md) : API JSON ou XML pour interfaçage avec d'autres applications
  * [ServicesXml](ServicesXml.md) : web services XML pour interfaçage avec d'autres applications (obsolète).
  * [AdminUsers](AdminUsers.md) : gestion des utilisateurs
  * [InterrogationPortail](InterrogationPortail.md) : liaison avec portail

docs/GuideDeveloppeurs.md

@@ -9,7 +9,7 @@ Informations pour les développeurs souhaitant étendre ou modifier ScoDoc.
    un serveur Discord ouvert sur invitation aux développeur actifs. Contacter Emmanuel.
  * [Générer de nouveaux formats de bulletins PDF](ApiGenerationBulletinsPdf.md)
  * [Créer de nouveaux types de "parcours"](ApiCreationParcours.md)
- * [API](ScoDocAPI.md) : API JSON ou XML pour interfaçage avec d'autres applications
+ * [API](ScoDoc9API.md) : API JSON ou XML pour interfaçage avec d'autres applications
  * Notes diverses
     * [Discussions pour la future gestion des absences](IdeesGestionAbsences.md)
     * [Anciennes discussions sur la gestion des plannings](IdeesGestionPlannings.md)

docs/PublicationEtudiants.md

@@ -7,7 +7,7 @@ Pour communiquer aux étudiants leurs réultats, plusieurs solutions:
  - Envoi des bulletins (pdf) par mail (c'est facile depuis le menu "Notes").
 
  - Publication sur un autre site Web: typiquement l'ENT de l'établissement, ou un mini-site dédié. 
-    - Pour interfacer un ENT, [voir l'API](ScoDocAPI.md).
+    - Pour interfacer un ENT, [voir l'API](ScoDoc9API.md).
     - Plusieurs collègues ont développé des mini-sites pour publier les notes (accès protégé par CAS ou autre). Ces codes ne font pas stricto censu partie de ScoDoc. Quelques exemples en PHP sont distribués dans le répertoire `misc/PublicationBulletins` ([voir ici](https://scodoc.org/git/viennet/ScoDoc/src/branch/master/misc/PublicationBulletins)).
     - Plus récemment (2020), des collègues de l'IUT de Mulhouse ont développé un mini-portail complet: [Scodoc_Notes](https://github.com/SebL68/Scodoc_Notes) (github), [historique](https://notes.iutmulhouse.uha.fr/maj.php).
 

docs/ScoDoc9API.md

@@ -23,6 +23,8 @@ L'URL complète est de la forme: `https://scodoc.example.com/ScoDoc/api/fonction
 
 # Fonctions de l'API ScoDoc 7 portées en ScoDoc 9
 
+L'ancienne API ScoDoc 7 est décrite ici: [ScoDocAPI](ScoDocAPI.md)
+
 Afin de garantir l'interopérabilité avec les clients ScoDoc 7 (ENT, etc), les
 fonctions suivantes sont disponibles avec le mécanisme d'authentification
 basique de ScoDoc 7. Elles sont considérées comme *obsolètes* ("deprecated") et
@@ -940,7 +942,7 @@ Et un autre exemple en format JSON:
 
 
 ##  En savoir plus 
-Voir l'exemple complet d'utilisation de l'API JSON en Python, dans `misc/example-api-1.py`
+Voir exemples d'utilisation de l'API en Python, dans `tests/api/`.
 
 
 

docs/ScoDocAPI.md

@@ -914,8 +914,7 @@ Et un autre exemple en format JSON:
 
 
 ##  En savoir plus 
-Voir l'exemple complet d'utilisation de l'API JSON en Python, dans `misc/example-api-1.py`
-
+Voir exemples d'utilisation de l'API en Python, dans `tests/api/`.
 
 
 

mkdocs.yml

@@ -18,7 +18,6 @@ nav:
     - 'Interfaces SI': InterrogationPortail.md
     - 'Publication des notes': PublicationEtudiants.md
     - 'Export Apogée': ScoDocApogee.md
-    - 'API': ScoDocAPI.md
 
   - Association: 
     - 'Association 1901': AssociationScoDoc.md
@@ -27,6 +26,8 @@ nav:
   - Développement:
     - 'Git': https://scodoc.org/git
     - 'Guide Développeurs': GuideDeveloppeurs.md
+    - 'API (interfaçages autres logiciels)': ScoDoc9API.md
+
 
   - FAQ: FAQ.md