diff --git a/docs-fr/calculators/pam/macrorugo_complexe.md b/docs-fr/calculators/pam/macrorugo_complexe.md
new file mode 100644
index 0000000000000000000000000000000000000000..02d5e760a21aa62761c59934a681679316424992
--- /dev/null
+++ b/docs-fr/calculators/pam/macrorugo_complexe.md
@@ -0,0 +1,16 @@
+# Passe à macro-rugosités complexe
+
+Ce module de calcul permet de calculer le débit transitant par une passe à macro-rugosité dite "complexe" car possédant un radier incliné ou de multiples radiers.
+
+## Caractéristiques générales
+
+Les paramètres à rentrer sont les mêmes que pour [la passe à macro-rugosité dite "simple"](macrorugo.md). Concernant le radier de la passe deux choix sont offerts :
+
+- Les radiers multiples : il est possible de créer, dupliquer, supprimer, changer l'ordre d'autant de radiers que nécessaire. Pour chaque radier, les paramètres à rentrer sont : la largeur du radier et la cote du radier à l'amont de la passe.
+- Le radier incliné : en plus de la largeur du radier, il faut entrer les cotes droite et gauche de radier à l'amont de la passe.
+
+Les données calculées sont les mêmes que pour [la passe à macro-rugosité dite "simple"](macrorugo.md). Les résultats affichent les différentes données pour chaque radier et le graphique permet de visualiser ces données pour chaque radier (profil transversal). Dans le cas où au moins un des paramètres de calcul varie, les résultats sont disponibles individuellement via une liste déroulante.
+
+## Cas du radier incliné
+
+Le calcul d'une passe à radier incliné consiste à discrétiser la passe en plusieurs radiers horizontaux. La largeur des radiers créés est fixée à la distance à la distance séparant deux blocs avec un ajustement des deux radiers situés aux extrémités pour obtenir la largeur totale de la passe. Il est possible d'éditer les radiers créés en sélectionnant "Radiers multiples" après avoir effectué un calcul avec un radier incliné.
diff --git a/docs-fr/general/parametres_application.md b/docs-fr/general/parametres_application.md
index a86840fb856e3de11a2ca2741d879f4afaeb7e31..4929fd8c483514a24f0e14683f256f8dc14087e9 100644
--- a/docs-fr/general/parametres_application.md
+++ b/docs-fr/general/parametres_application.md
@@ -2,6 +2,11 @@
 
 Accessible depuis le menu latéral gauche, les paramètres de l'application modifiables par l'utilisateur sont les suivants :
 
-- Précision d'affichage : Nombre de décimales affichées pour les résultats des calculs;
-- Précision de calcul : précision de calcul utilisée par défaut lors de la création d'un module de calcul;
-- Nombre d'itération de l'algorithme de résolution : pour les calculs résolus avec un algorithme de résolution, nombre d'itération maximum de l'algorithme.
+- Nombre de décimales affichées : Nombre de décimales affichées pour les résultats des calculs. Pour les nombres proches de zéro affichés en notation scientifique, cette option règle le nombres de chiffres significatifs affichés ;
+- Précision de calcul : Précision utilisée pour la convergence des calculs numériques ([Méthode de Brent](https://fr.wikipedia.org/wiki/M%C3%A9thode_de_Brent) ou [méthode de Newton](https://fr.wikipedia.org/wiki/M%C3%A9thode_de_Newton)) ;
+- Nombre d'itération de l'algorithme de Newton ;
+- Activer les notifications à l'écran : autorise l'affichage de notifications lors de certaines opérations (avertissement au chargement d'une session, invalidation de calcul...) ;
+- Activer les raccourcis clavier: autorise l'utilisation des raccourcis clavier (Voir liste des raccourcis disponibles) ;
+- Langue : définit la langue des interfaces du logiciel en français ou en anglais (N.B. : la documentation n'existe qu'en français).
+
+Le bouton d'enregistrement en haut de la fenêtre permet d'enregistrer les préférences de l'utilisateur dans son navigateur pour les utilisations ultérieures. Le bouton "Reset" permet de restaurer les réglages par défaut de l'application.
diff --git a/docs-fr/general/principe_fonctionnement.md b/docs-fr/general/principe_fonctionnement.md
index a5dcf07fd001b1c0489a80e553993ca2bf722f31..1ae838e9af313d6d0efca45e52e2babfde771abf 100644
--- a/docs-fr/general/principe_fonctionnement.md
+++ b/docs-fr/general/principe_fonctionnement.md
@@ -1,6 +1,6 @@
 # Principe de fonctionnement d'un module de calcul
 
-Les modules de calcul de Cassiopée permettent chacun de calculer une grandeur au choix parmi celles intervenant dans une ou plusieurs équations.
+Les modules de calcul de Cassiopée permettent chacun de calculer un paramètre au choix parmi celles intervenant dans une ou plusieurs équations.
 
 ## Ouvrir un nouveau module de calcul
 
@@ -12,41 +12,56 @@ La liste des modules ouverts apparaît dans le bandeau supérieur et permet de n
 
 ## Comment s'opèrent les choix pour effectuer un calcul ou une série de calcul ?
 
-Le module se présente sous la forme d'une série de grandeurs intervenant dans l'équation.
+Le module se présente sous la forme d'une série de paramètres intervenant dans la résolution de l'équation du module de calcul.
 
-![Série de grandeurs du module de calcul du volume des bassins d'une passe à bassin](principe_fonctionnement_grandeurs.png)
+![Paramètres du module de calcul de la chute d'une passe à bassin](principe_fonctionnement_grandeurs.png)
 
- et pour chacune d'entre elle, l'utilisateur peut au choix :
+Pour chacun d'entre eux, l'utilisateur peut au choix :
 
-- Fixer une grandeur (Bouton "FIXÉ");
-- Choisir la grandeur qui sera calculée (Bouton "CALCULER");
-- Choisir la grandeur qui varie afin d'effectuer une série de calcul (Bouton "VARIER")
+- Fixer le paramètre (Bouton "FIXÉ");
+- Faire varier le paramètre afin d'effectuer une série de calcul (Bouton "VARIER")
+- Choisir le paramètre qui sera calculé (Bouton "CALCULER");
 
-L'interface est conçue pour qu'une grandeur et une seule soit choisie pour le calcul et pour qu'au plus une grandeur varie pour effectuer une série de calcul.
+L'interface est conçue pour qu'un paramètre et un seul soit choisi pour le calcul. Les paramètres qui ne peuvent être calculés ne sont pas pourvus du bouton "CALCULER".
 
-Les grandeurs qui ne peuvent être calculées ne sont pas pourvues du bouton "CALCULER".
-
-## Comment faire varier une grandeur pour effectuer une série de calculs
+## Comment faire varier un paramètre pour effectuer une série de calculs
 
 Une série de calculs peut être lancée entre une valeur min et une valeur max pour un pas donné :
 
-![Définition des valeurs mni, max et du pas pour une grandeur à varier](principe_fonctionnement_varie_pas.png)
+![Définition des valeurs mni, max et du pas pour un paramètre à varier](principe_fonctionnement_varie_pas.png)
 
 Ou pour une liste de valeurs définies :
 
-![Définition d'une liste de valeurs pour une grandeur à varier](principe_fonctionnement_varie_liste.png)
+![Définition d'une liste de valeurs pour un paramètre à varier](principe_fonctionnement_varie_liste.png)
+
+L'import d'une liste de valeur s'effectue soit par saisie ou copier/coller dans le champ "Liste de valeurs" ou par un fichier texte. Le séparateur décimal est configurable. Tout caractère en dehors des caractères numériques, la lettre "E" et le séparateur décimal sera considéré comme séparateur entre les valeurs. De fait, le séparateur pourra être la virgule, le point-virgule, l'espace, la tabulation, le retour charriot...
 
+Le titre de la fenêtre contient le nombre d'occurrences correspondant. Un clic sur le logo en forme de graphique à droite du titre de la fenêtre permet d'afficher un graphique des variations du paramètre.
+
+Pour le cas où plusieurs paramètres varient et qu'ils n'ont pas le même nombre d'occurrences, il faut définir une stratégie d'extension des listes les plus courtes pour les adaptés à la liste du paramètre ayant le plus d'occurrences. Deux stratégies sont disponibles : répéter la dernière valeur ou réutiliser les valeurs de la liste depuis la première occurrence.
 
 ## Comment lancer un calcul ou une série de calcul
 
-Cliquer sur le bouton "Calculer" situé au bas de l'écran.
+Presser la touche [Entrée] ou cliquer sur le bouton "Calculer" situé au bas de l'écran.
 
 ## Les résultats du calcul
 
-Pour des grandeurs fixées, le panneau de résultat affiche les grandeurs fixées et la grandeur calculée ainsi que d'éventuels résultats complémentaires.
+Pour des paramètres fixés, le panneau de résultat affiche les paramètres fixés et le paramètre calculé ainsi que d'éventuels résultats complémentaires.
 
 ![Résultat d'un calcul pour des grandeurs fixées](principe_fonctionnement_resultat_fix.png)
 
-Pour une grandeur qui varie, le panneau de résultat affiche un graphique d'évolution de la grandeur calculée en fonction de la grandeur qui varie, un tableau reprenant les grandeurs fixées et un tableau reprenant les valeurs de la grandeur qui varie, les valeurs de la grandeur calculée et les valeurs des éventuels résultats complémentaires.
+Pour un ou plusieurs paramètres qui varient, le panneau de résultat affiche :
+
+- un graphique d'évolution sur lequel on peut choisir le paramètre à utiliser en abscisse et en ordonnée ;
+- un tableau reprenant les paramètres fixés ;
+- un tableau reprenant les paramètres qui varient et le paramètre calculé ainsi que les valeurs des éventuels résultats complémentaires.
+
+![Résultat d'une série de calculs pour un paramètre qui varie](principe_fonctionnement_resultat_var.png)
+
+Les tableaux et graphiques sont pourvues de différentes fonctionnalités :
+
+- un bouton de téléchargement pour récupérer le contenu du tableau au format XLS 
+- un bouton de téléchargement pour récupérer le graphique affiché au format PNG 
+- un bouton pour afficher le tableau ou le graphique en plein écran.
 
-![Résultat d'une série de calculs pour une grandeur qui varie](principe_fonctionnement_resultat_var.png)
+Les graphiques sont pourvus d'un zoom accessible en effectuant une sélection à la souris sur le graphique. Le bouton avec la flèche faisant un demi-tour à gauche permet de réinitialiser le zoom à sa valeur d'origine affichant toutes les valeurs disponibles.
diff --git a/docs-fr/general/principe_fonctionnement_bandeau_superieur.png b/docs-fr/general/principe_fonctionnement_bandeau_superieur.png
index b0c7a0e3d46a8d911795f8b9f06f22949c908fe3..b4f53d0c107c9863eadab7c489d77b66543eb9c6 100644
Binary files a/docs-fr/general/principe_fonctionnement_bandeau_superieur.png and b/docs-fr/general/principe_fonctionnement_bandeau_superieur.png differ
diff --git a/docs-fr/general/principe_fonctionnement_grandeurs.png b/docs-fr/general/principe_fonctionnement_grandeurs.png
index 5f705bfa84c9fde2cee61a62a056977e65eed6c4..2c31247c318f1dd031a5e8876cdecd78cdcb6b38 100644
Binary files a/docs-fr/general/principe_fonctionnement_grandeurs.png and b/docs-fr/general/principe_fonctionnement_grandeurs.png differ
diff --git a/docs-fr/general/principe_fonctionnement_resultat_fix.png b/docs-fr/general/principe_fonctionnement_resultat_fix.png
index c5f0918734ad5a2cae9916dd28836e6cc5a42a6c..b46e4068b11cec103675745be1caf305713a29ad 100644
Binary files a/docs-fr/general/principe_fonctionnement_resultat_fix.png and b/docs-fr/general/principe_fonctionnement_resultat_fix.png differ
diff --git a/docs-fr/general/principe_fonctionnement_resultat_var.png b/docs-fr/general/principe_fonctionnement_resultat_var.png
index 5217d97c961b2dec044a61b9225bd6410f80162e..3f7e62ec17ec320b75438536f596b6c1975b325e 100644
Binary files a/docs-fr/general/principe_fonctionnement_resultat_var.png and b/docs-fr/general/principe_fonctionnement_resultat_var.png differ
diff --git a/docs-fr/general/principe_fonctionnement_varie_liste.png b/docs-fr/general/principe_fonctionnement_varie_liste.png
index 8b95ce228b5801db5398c43b2820ea6c982dd1c1..7dde883a31561ab88a7a96b24511bf8901f6d804 100644
Binary files a/docs-fr/general/principe_fonctionnement_varie_liste.png and b/docs-fr/general/principe_fonctionnement_varie_liste.png differ
diff --git a/docs-fr/general/principe_fonctionnement_varie_pas.png b/docs-fr/general/principe_fonctionnement_varie_pas.png
index fd5b8a96ba3d8b387db8f54a155aa6fc9dbdd453..39040f28a6f32fbd349a1c5b8edd1434e7d695f3 100644
Binary files a/docs-fr/general/principe_fonctionnement_varie_pas.png and b/docs-fr/general/principe_fonctionnement_varie_pas.png differ
diff --git a/docs-fr/general/raccourcis_clavier.md b/docs-fr/general/raccourcis_clavier.md
new file mode 100644
index 0000000000000000000000000000000000000000..ff45666060374c88dc6cfb5eac63213131e620bd
--- /dev/null
+++ b/docs-fr/general/raccourcis_clavier.md
@@ -0,0 +1,14 @@
+# Liste des raccourcis clavier
+
+Pour utiliser les raccourcis clavier, il faut activer l'option dans [les paramètres de l'application](parametres_application.md).
+
+- Alt + S : Enregistre la session courante
+- Alt + O : Ouvre une nouvelle session
+- Alt + Q : Vide la session courante
+- Alt + N : Ajoute un module de calcul à la session courante
+- Alt + ↵ : Lance le calcul du module en cours
+- Alt + D : Duplique le module en cours
+- Alt + W : Ferme le module en cours
+- Alt + 1 : Positionne la page sur la section "Données" du module en cours
+- Alt + 2 : Positionne la page sur la section "Résultats" du module en cours
+- Alt + 3 : Positionne la page sur la section "Graphique" du module en cours
diff --git a/docs-fr/index.md b/docs-fr/index.md
index 4857c3de013c41789c3f95d0675df82b897163ef..3b28d2a53e52fabde443fba5ffe0678b3023ee58 100644
--- a/docs-fr/index.md
+++ b/docs-fr/index.md
@@ -2,11 +2,8 @@
 
 ## Caractéristiques générales
 
-Cassiopée est un logiciel consacré à l'hydraulique des rivières avec notamment l'aide au dimensionnement des passes à poissons, l'hydraulique agricole et l'hydraulique à surface libre en général. Il se présente sous la forme de modules de calcul indépendants permettant chacun de résoudre un problème donné. Les modules de calcul peuvent être enchaînés (des paramètres ou des résultats de calcul peuvent être "liés" entre modules) afin de réaliser des enchaînements de calculs complexe. L'utilisateur peut enregistrer localement les modules utilisés afin de les réutiliser ultérieurement.
+Cassiopée est un logiciel consacré à l'hydraulique des rivières avec notamment l'aide au dimensionnement des passes à poissons, l'hydraulique agricole et l'hydraulique à surface libre en général. Il se présente sous la forme de [modules de calcul](general/principe_fonctionnement.md) indépendants permettant chacun de résoudre un problème donné. Les modules de calcul peuvent être enchaînés (des paramètres ou des résultats de calcul peuvent être "liés" entre modules) afin de réaliser des enchaînements de calculs complexe. L'utilisateur peut enregistrer localement les modules utilisés afin de les réutiliser ultérieurement.
 
 ## Pré-requis - installation
 
 Cassiopée ne nécessite aucune installation. Il est disponible en ligne à partir d'un navigateur récent (testé sous Firefox, Chrome et Chromium) en se rendant à l'adresse suivante : [http://cassiopee.g-eau.net](http://cassiopee.g-eau.net)
-
-
-
diff --git a/mkdocs.yml b/mkdocs.yml
index 193755a0193f9577ef5a035cd42f7a162b0dc955..a1eeadde6cd88a09b140be3f584419dfb294fd2c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -3,7 +3,11 @@ site_author: UMR G-EAU
 docs_dir: docs-fr
 site_dir: src/assets/docs-fr/
 copyright: CC BY-NC-ND 4.0, UMR G-EAU 2019
-theme: material
+repo_name: 'cassiopee'
+repo_url: 'https://gitlab.irstea.fr/cassiopee'
+theme:
+    name: 'material'
+    language: 'fr'
 use_directory_urls: false
 extra_javascript:
     - javascripts/mathjax/MathJax.js?config=TeX-AMS_CHTML
@@ -16,6 +20,7 @@ nav:
         - index.md
         - general/principe_fonctionnement.md
         - general/parametres_application.md
+        - general/raccourcis_clavier.md
     - Hydraulique en charge:
         - calculators/hyd_en_charge/lechapt-calmon.md
         - calculators/hyd_en_charge/cond_distri.md
@@ -37,5 +42,6 @@ nav:
     - Passes à macro-rugosité:
         - calculators/pam/macrorugo.md
         - calculators/pam/macrorugo_theorie.md
+        - calculators/pam/macrorugo_complexe.md
     - CHANGELOG.md
     - mentions_legales.md
diff --git a/src/app/calculators/cloisons/cloisons.config.json b/src/app/calculators/cloisons/cloisons.config.json
index 45909a4aa19163ff1bc7babdd7b3b226e7870034..a59fd3b14b393bbd0a0aa900922c9cda137cb53b 100644
--- a/src/app/calculators/cloisons/cloisons.config.json
+++ b/src/app/calculators/cloisons/cloisons.config.json
@@ -27,6 +27,11 @@
             {
                 "id": "select_loidebit",
                 "type": "select",
+                "help": {
+                    "Orifice_OrificeSubmerged": "structures/orifice_noye",
+                    "SeuilRectangulaire_WeirVillemonte": "structures/kivi",
+                    "SeuilRectangulaire_WeirSubmergedLarinier": "structures/fente_noyee"
+                },
                 "source": "device_loi_debit"
             },
             "h1",
diff --git a/src/app/calculators/cloisons/cloisons.en.json b/src/app/calculators/cloisons/cloisons.en.json
index 983d797a5b453bb67c4a3bdf9f267245f4d18b4c..358a74f9e7d5b6107576f0038aba044ef6957992 100644
--- a/src/app/calculators/cloisons/cloisons.en.json
+++ b/src/app/calculators/cloisons/cloisons.en.json
@@ -14,9 +14,9 @@
     "select_loidebit_SeuilRectangulaire_WeirSubmergedLarinier": "Submerged slot (Larinier 1992)",
     "select_loidebit_SeuilRectangulaire_WeirVillemonte": "Villemonte 1947",
 
-    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Free flow triangular weir",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Triangular weir (Villemonte)",
 
-    "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Free flow truncated triangular weir",
+    "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Truncated triangular weir (Villemonte)",
 
 	"UNIT_PV": "W/m³",
 	"UNIT_Q": "m³/s",
diff --git a/src/app/calculators/cloisons/cloisons.fr.json b/src/app/calculators/cloisons/cloisons.fr.json
index f98900e228931e0956f512caddf4313bb46bc2d1..e7a969a49ce3b641a98d23c76fa84560bdf44379 100644
--- a/src/app/calculators/cloisons/cloisons.fr.json
+++ b/src/app/calculators/cloisons/cloisons.fr.json
@@ -11,9 +11,9 @@
     "select_loidebit_SeuilRectangulaire_WeirSubmergedLarinier": "Fente noyée (Larinier 1992)",
     "select_loidebit_SeuilRectangulaire_WeirVillemonte": "Villemonte 1947",
 
-    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Déversoir triangulaire dénoyé",
+    "select_loidebit_SeuilTriangulaire_TriangularWeirFree": "Déversoir triangulaire (Villemonte)",
 
-    "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Déversoir triangulaire tronqué dénoyé",
+    "select_loidebit_SeuilTriangulaireTrunc_TriangularTruncWeirFree": "Déversoir triangulaire tronqué (Villemonte)",
 
 	"UNIT_PV": "W/m³",
 	"UNIT_Q": "m³/s",
diff --git a/src/app/calculators/macrorugo-compound/macrorugo-compound.config.json b/src/app/calculators/macrorugo-compound/macrorugo-compound.config.json
index 5f9ef98981e53428f048194be3596b6d15b242be..4d3f2859f5c723c1caaebc4e6ce836c78190d9f9 100644
--- a/src/app/calculators/macrorugo-compound/macrorugo-compound.config.json
+++ b/src/app/calculators/macrorugo-compound/macrorugo-compound.config.json
@@ -59,6 +59,6 @@
         "type": "options",
         "idCal": "Q",
         "apronTypeSelectId": "select_pass_type",
-        "help": "pam/macrorugo-compound"
+        "help": "pam/macrorugo_complexe"
     }
 ]
\ No newline at end of file
diff --git a/src/app/calculators/pab/pab.config.json b/src/app/calculators/pab/pab.config.json
index edca91704834dc3734eec3bbe0282c36eebbbb77..24f58796ad0e5589e3deb1bbab84352732bb6ffa 100644
--- a/src/app/calculators/pab/pab.config.json
+++ b/src/app/calculators/pab/pab.config.json
@@ -12,5 +12,9 @@
     {
         "id": "tableau_entree_pab",
         "type": "pab_table"
+    },
+    {
+        "type": "options",
+        "help": "pab/pab"
     }
 ]
diff --git a/src/app/calculators/parallel-structures/parallel-structures.config.json b/src/app/calculators/parallel-structures/parallel-structures.config.json
index 204a70147b07d5da1a94569a0a91929d8a5d6dd1..e727f19c54095702091cb065c7d632ec9a5855b9 100644
--- a/src/app/calculators/parallel-structures/parallel-structures.config.json
+++ b/src/app/calculators/parallel-structures/parallel-structures.config.json
@@ -25,7 +25,10 @@
                 "id": "select_loidebit",
                 "type": "select",
                 "help": {
-                    "SeuilRectangulaire_KIVI": "structures/kivi"
+                    "SeuilRectangulaire_KIVI": "structures/kivi",
+                    "SeuilRectangulaire_WeirVillemonte": "structures/kivi",
+                    "Orifice_OrificeSubmerged": "structures/orifice_noye",
+                    "SeuilRectangulaire_WeirSubmergedLarinier": "structures/fente_noyee"
                 },
                 "source": "device_loi_debit"
             },
@@ -55,6 +58,7 @@
     {
         "type": "options",
         "ouvrageSelectId": "select_structure",
-        "idCal": "Q"
+        "idCal": "Q",
+        "help": "structures/lois_ouvrages"
     }
 ]
\ No newline at end of file