From 0cdfb1c5a8b6e173af5502503701237c081e4c39 Mon Sep 17 00:00:00 2001
From: "mathias.chouet" <mathias.chouet@irstea.fr>
Date: Tue, 26 Nov 2019 17:31:22 +0100
Subject: [PATCH] Work on english documentation

---
 docs-en/avant-propos.md                    | 22 +++--
 docs-en/general/parametres_application.md  | 18 ++---
 docs-en/general/principe_fonctionnement.md | 74 ++++++++---------
 docs-en/general/raccourcis_clavier.md      | 22 ++---
 docs-en/index.md                           | 10 +--
 docs-en/mentions_legales.md                | 94 +++++++++++-----------
 docs-fr/general/parametres_application.md  |  4 +-
 docs-fr/general/principe_fonctionnement.md |  2 +-
 mkdocs-en.yml                              | 48 +++++------
 9 files changed, 145 insertions(+), 149 deletions(-)

diff --git a/docs-en/avant-propos.md b/docs-en/avant-propos.md
index de56100f7..bdeac7e6b 100644
--- a/docs-en/avant-propos.md
+++ b/docs-en/avant-propos.md
@@ -1,20 +1,16 @@
-# Avant-Propos
+# Foreword
 
-Concernant les passes à poissons, le logiciel CASSIOPEE doit être considéré comme un outil d'aide à la conception des passes à
-poissons.
+For fish passes, the CASSIOPEE software should be considered as a tool to assist in the design of fish passes.
 
-Son utilisateur doit être parfaitement familier de la technique de dimensionnement des passes à
-poissons.
+Its user must be perfectly familiar with the technique of sizing fish passes.
 
-Dans le processus de mise au point d'une passe à poissons, la fonction de CASSIOPEE est de calculer
-certaines grandeurs caractérisant son fonctionnement et de présenter les résultats de façon claire et
-conviviale.
+In the process of developing a fish pass, the role of CASSIOPEE is to calculate
+certain quantities characterizing its operation and to present the results in a clear, concise and friendly manner.
 
-Il ne peut évidemment répondre au problème de l'optimisation de l'implantation de l'ouvrage sur le
+It obviously cannot answer the problem of optimizing the location of the structure on the
 site.
 
-Il convient à l'utilisateur de vérifier que le projet élaboré répond bien au problème posé et que toutes
-les conditions assurant sa franchissabilité sont satisfaites.
+It is advisable for the user to check that the project developed responds to the problem and that all
+the conditions ensuring its crossability are met.
 
-En aucun cas l'AFB ou Irstea ne pourront être tenus responsables du mauvais fonctionnement
-d'un projet dimensionné avec CASSIOPEE.
+Under no circumstances can the AFB or Irstea be held responsible for any malfunction of a project designed using CASSIOPEE.
diff --git a/docs-en/general/parametres_application.md b/docs-en/general/parametres_application.md
index 0b3d8453d..e28605f4a 100644
--- a/docs-en/general/parametres_application.md
+++ b/docs-en/general/parametres_application.md
@@ -1,12 +1,12 @@
-# Paramètres de l'application
+# Application parameters
 
-Accessible depuis le menu latéral gauche, les paramètres de l'application modifiables par l'utilisateur sont les suivants&nbsp;:
+Accessible from the left side menu, the application parameters that can be modified by the user are as follows:
 
-- Nombre de décimales affichées&nbsp;: 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&nbsp;;
-- Précision de calcul&nbsp;: 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))&nbsp;;
-- Nombre d'itération de l'algorithme de Newton&nbsp;;
-- Activer les notifications à l'écran&nbsp;: autorise l'affichage de notifications lors de certaines opérations (avertissement au chargement d'une session, invalidation de calcul...)&nbsp;;
-- Activer les raccourcis clavier: autorise l'utilisation des raccourcis clavier (Voir liste des raccourcis disponibles)&nbsp;;
-- Langue&nbsp;: définit la langue des interfaces du logiciel en français ou en anglais (N.B.&nbsp;: la documentation n'existe qu'en français).
+- Number of decimal places displayed: Number of decimal places displayed for the calculation results. For numbers close to zero displayed in scientific notation, this option sets the number of significant digits displayed;
+- Calculation accuracy: Precision used for the convergence of numerical calculations ([Brent's method](https://en.wikipedia.org/wiki/Brent%27s_method) or [Newton's method](https://en.wikipedia.org/wiki/Newton's_method));
+- Number of iterations of the Newton's algorithm;
+- Enable on-screen notifications: allows notifications to be displayed during certain operations (warning when loading a session, calculation invalidation...);
+- Enable keyboard shortcuts: allows the use of keyboard shortcuts (See [list of available shortcuts](raccourcis_clavier));
+- Language: defines the language of the software interfaces in French or English.
 
-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.
+The save button at the top of the window allows you to save the user's preferences in your browser for future use. The "Reset" button restores the application's default settings.
diff --git a/docs-en/general/principe_fonctionnement.md b/docs-en/general/principe_fonctionnement.md
index 370800c4c..25babe5fb 100644
--- a/docs-en/general/principe_fonctionnement.md
+++ b/docs-en/general/principe_fonctionnement.md
@@ -1,67 +1,67 @@
-# Principe de fonctionnement d'un module de calcul
+# Principle of operation of a calculation module
 
-Les modules de calcul de Cassiopée permettent chacun de calculer un paramètre au choix parmi celles intervenant dans une ou plusieurs équations.
+Each Cassiopée calculation module allows you to calculate a parameter of your choice from those in one or more equations.
 
-## Ouvrir un nouveau module de calcul
+## Open a new calculation module
 
-![Bandeau supérieur de l'application avec le menu, la liste des modules ouverts et le bouton pour ajouter un nouveau module](principe_fonctionnement_bandeau_superieur.png)
+![Top banner of the application with the menu, the list of open modules and the button to add a new module](principe_fonctionnement_bandeau_superieur.png)
 
-La liste des modules est disponible au lancement de l'application. Après avoir ouvert un nouveau module de calcul, cette liste est disponible via le bouton "+" situé dans le bandeau supérieur ou par le menu "☰" puis le lien "Nouveau module de calcul" situé dans le menu.
+The list of modules is available when the application is launched. After opening a new calculation module, this list is available via the "+" button located in the upper banner or via the "☰" menu and then the "New calculation module" link located in the menu.
 
-La liste des modules ouverts apparaît dans le bandeau supérieur et permet de naviguer entre les modules ouverts.
+The list of open modules appears in the upper banner and allows you to navigate between open modules.
 
-## Comment s'opèrent les choix pour effectuer un calcul ou une série de calcul&nbsp;?
+## How are the choices made to perform a calculation or a series of calculations ?
 
-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.
+The module is presented as a series of parameters involved in solving the equation of the calculation module.
 
-![Paramètres du module de calcul de la chute d'une passe à bassin](principe_fonctionnement_grandeurs.png)
+![Parameters of the module for calculating the fall of a basin pass](principe_fonctionnement_grandeurs.png)
 
-Pour chacun d'entre eux, l'utilisateur peut au choix&nbsp;:
+For each of them, the user can choose:
 
-- 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");
+- Set the parameter's value ("FIXED" button);
+- Vary the parameter to perform a series of calculations ("VARIATED" button)
+- Choose the parameter that will be calculated ("CALCULATE" button);
 
-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".
+The interface is designed so that one and only one parameter is chosen for the calculation. Parameters that cannot be calculated do not have a "CALCULATE" button.
 
-## Comment faire varier un paramètre pour effectuer une série de calculs
+## How to vary a parameter to perform a series of calculations
 
-Une série de calculs peut être lancée entre une valeur min et une valeur max pour un pas donné&nbsp;:
+A series of calculations can be triggered between a minimum value and a maximum value for a given step:
 
-![Définition des valeurs mni, max et du pas pour un paramètre à varier](principe_fonctionnement_varie_pas.png)
+![Define min, max and step values for a parameter to be varied](principe_fonctionnement_varie_pas.png)
 
-Ou pour une liste de valeurs définies&nbsp;:
+Or for a list of defined values:
 
-![Définition d'une liste de valeurs pour un paramètre à varier](principe_fonctionnement_varie_liste.png)
+![Defining a list of values for a parameter to be varied](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...
+Importing a values list is done either by typing or copy/pasting in the "Values list" field, or by importing a text file. The decimal separator is configurable. Any character outside the numeric characters, the letter "E" and the decimal separator will be considered as separator between the values. The separator could be the comma, the semicolon, the space, the tabulation, the carriage return...
 
-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.
+The window title contains the corresponding number of occurrences. Clicking on the graphic logo to the right of the window title displays a chart of the parameter variations.
 
-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&nbsp;: répéter la dernière valeur ou réutiliser les valeurs de la liste depuis la première occurrence.
+In case several parameters vary and they do not have the same number of occurrences, it is necessary to define a strategy to extend the shortest lists to fit the list of the parameter with the most occurrences. Two strategies are available: repeat the last value or reuse the values in the list since the first occurrence.
 
-## Comment lancer un calcul ou une série de calcul
+## How to launch a calculation or a series of calculations
 
-Presser la touche [Entrée] ou cliquer sur le bouton "Calculer" situé au bas de l'écran.
+Press the [Enter] key or click on the "Calculate" button at the bottom of the page.
 
-## Les résultats du calcul
+## Calculation results
 
-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.
+For fixed parameters, the results panel displays the fixed parameters and the calculated parameter as well as any additional results.
 
-![Résultat d'un calcul pour des grandeurs fixées](principe_fonctionnement_resultat_fix.png)
+![Result of a calculation for fixed values](principe_fonctionnement_resultat_fix.png)
 
-Pour un ou plusieurs paramètres qui varient, le panneau de résultat affiche&nbsp;:
+For one or more varying parameters, the results panel displays:
 
-- un graphique d'évolution sur lequel on peut choisir le paramètre à utiliser en abscisse et en ordonnée&nbsp;;
-- un tableau reprenant les paramètres fixés&nbsp;;
-- un tableau reprenant les paramètres qui varient et le paramètre calculé ainsi que les valeurs des éventuels résultats complémentaires.
+- an evolution graph on the which you can choose the parameter to use on the x-axis and y-axis;
+- a table containing the parameters set;
+- a table showing the parameters that vary and the calculated parameter as well as the values of any additional results.
 
-![Résultat d'une série de calculs pour un paramètre qui varie](principe_fonctionnement_resultat_var.png)
+![Results of a series of calculations for a varying parameter](principe_fonctionnement_resultat_var.png)
 
-Les tableaux et graphiques sont pourvues de différentes fonctionnalités&nbsp;:
+The tables and charts are provided with different functionalities:
 
-- un bouton de téléchargement pour récupérer le contenu du tableau au format XLS&nbsp;
-- un bouton de téléchargement pour récupérer le graphique affiché au format PNG&nbsp;
-- un bouton pour afficher le tableau ou le graphique en plein écran.
+- a download button to retrieve the table content in XLSX format;
+- a download button to retrieve the chart in PNG format;
+- a button to display the table or chart in full screen.
 
-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.
+The charts are zoomed in by making a mouse selection on some area. The button with the curved left-pointing arrow resets the zoom to its original value displaying all available values.
diff --git a/docs-en/general/raccourcis_clavier.md b/docs-en/general/raccourcis_clavier.md
index ff4566606..ef4bc97d4 100644
--- a/docs-en/general/raccourcis_clavier.md
+++ b/docs-en/general/raccourcis_clavier.md
@@ -1,14 +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).
+To use keyboard shortcuts, the feature must be enabled in [application parameters](parametres_application.md).
 
-- Alt + S&nbsp;: Enregistre la session courante
-- Alt + O&nbsp;: Ouvre une nouvelle session
-- Alt + Q&nbsp;: Vide la session courante
-- Alt + N&nbsp;: Ajoute un module de calcul à la session courante
-- Alt + ↵&nbsp;: Lance le calcul du module en cours
-- Alt + D&nbsp;: Duplique le module en cours
-- Alt + W&nbsp;: Ferme le module en cours
-- Alt + 1&nbsp;: Positionne la page sur la section "Données" du module en cours
-- Alt + 2&nbsp;: Positionne la page sur la section "Résultats" du module en cours
-- Alt + 3&nbsp;: Positionne la page sur la section "Graphique" du module en cours
+- Alt + S&nbsp;: Saves the current session
+- Alt + O&nbsp;: Opens a session file
+- Alt + Q&nbsp;: Empties the current session
+- Alt + N&nbsp;: Adds a new calculation module to the current session
+- Alt + ↵&nbsp;: Triggers calculation of the current module
+- Alt + D&nbsp;: Duplicates the current module
+- Alt + W&nbsp;: Closes the current module
+- Alt + 1&nbsp;: Positions the page on the "Input" section of the current module
+- Alt + 2&nbsp;: Positions the page on the "Results" section of the current module
+- Alt + 3&nbsp;: Positions the page on the "Charts" section of the current module
diff --git a/docs-en/index.md b/docs-en/index.md
index c5855385a..902b25e42 100644
--- a/docs-en/index.md
+++ b/docs-en/index.md
@@ -1,4 +1,4 @@
-# Présentation du logiciel Cassiopée
+# Presentation of Cassiopée software
 
 <div style="height: 86px; border: solid #aaa 2px; padding: 10px; padding-right: 20px; border-radius: 5px; display: inline-block;">
   <a href="http://cassiopee.g-eau.fr" style="text-decoration: none;">
@@ -7,10 +7,10 @@
   </a>
 </div>
 
-## Caractéristiques générales
+## General characteristics
 
-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.
+Cassiopée is a software dedicated to rivers hydraulics with especially some help for sizing fish passes, agricultural hydraulics anf poen-channel hydraulics in general. It comes in the form of independent [calculation modules](general/principe_fonctionnement.md) allowing one to solve a given problem. Calculation modules maybe chained (parameters or calculation results may be "linked" from one module to another) in order to build complex calculation chains. Users may locally save the modules they use, in order to reuse them later.
 
-## Pré-requis - installation
+## Pre-requisites - 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&nbsp;: [http://cassiopee.g-eau.fr](http://cassiopee.g-eau.fr)
+Cassiopée does not require any installation. It is available online using an up-to-date browser (tested with Firefox, Chrome and Chromium) by navigating to the following address: [http://cassiopee.g-eau.fr](http://cassiopee.g-eau.fr)
diff --git a/docs-en/mentions_legales.md b/docs-en/mentions_legales.md
index c06074901..46f08925e 100644
--- a/docs-en/mentions_legales.md
+++ b/docs-en/mentions_legales.md
@@ -1,101 +1,101 @@
-# Mentions légales et conditions d'utilisation
+# Legal notice and terms of use
 
-## Éditeur
+## Editor
 
-Le site cassiopee.g-eau.fr dénommé ci-après « Cassiopée » est édité par [l’UMR G-EAU (Unité Mixte de Recherche Gestion de l'Eau, Acteurs, Usages)](http://g-eau.fr):
+The site cassiopee.g-eau.fr hereinafter referred to as "Cassiopée" is published by [the UMR G-EAU (Mixed Research Unit "Water Management, Actors, Uses")](http://g-eau.fr):
 
 > Irstea<br/>
-> Centre de Montpellier<br/>
-> 361, rue Jean-François Breton<br/>
+> Centre of Montpellier<br/>
+> 361 Jean-François Breton Street<br/>
 > BP 5095<br/>
 > 34196 Montpellier Cedex 5<br/>
 > France
 
-> Tél&nbsp;: +33 (0) 4 67 04 63 00
+> Tel: +33 (0) 4 67 04 63 00
 
-Directeur de publication&nbsp;: Olivier Barreteau, Directeur de l’UMR G-EAU
+Director of publication: Olivier Barreteau, Director of the UMR G-EAU
 
-Responsable du projet de développement&nbsp;: David Dorchies
+Development Project Manager: David Dorchies
 
-Développeurs&nbsp;: François Grand, Mathias Chouet
+Developers: François Grand, Mathias Chouet
 
-Cassiopée est un outil proposé par [l'AFB (Agence Française pour la Biodiversité)](https://www.afbiodiversite.fr/) dans le cadre des conventions AFB-Irstea (Action n°100 de la convention 2016-2018 et  Action n°21 de la convention 2019-2021).
+Cassiopée is a tool proposed by [AFB (French Agency for Biodiversity)](https://www.afbiodiversite.fr/) within the framework of the AFB-Irstea conventions (Action n°100 of the 2016-2018 convention and Action n°21 of the 2019-2021 convention).
 
-## Hébergement
+## Hosting
 
 > Irstea<br/>
-> Centre de Montpellier<br/>
-> Direction des systèmes d'information<br/>
-> 361, rue Jean-François Breton<br/>
+> Centre of Montpellier<br/>
+> Information Systems Department<br/>
+> 361 Jean-François Breton Street<br/>
 > BP 5095<br/>
 > 34196 Montpellier Cedex 5<br/>
 > France
 
-## Contenus du logiciel Cassiopée
+## Contents of the Cassiopée software
 
-L'AFB et l'UMR G-EAU proposent l’accès à des outils de calcul dans le domaine de l'hydraulique et plus spécifiquement des outils d'aide au dimensionnement de passes à poissons.
+The AFB and the UMR G-EAU offer access to calculation tools in the field of hydraulics and more specifically tools to assist in the sizing of fish passes.
 
-L’accès des internautes au site et aux outils de Cassiopée est gratuit et illimité pour tous les usages privés comme professionnels, dès lors que cet accès se fait par les seuls outils et interfaces du site cassiopee.g-eau.fr.
+Internet users' access to the Cassiopee site and tools is free and unlimited for all private and professional uses, as long as this access is made only through the tools and interfaces of the site cassiopee.g-eau.fr.
 
-Sauf mention contraire, la propriété intellectuelle du contenu des pages est détenue par l'Institut national de Recherche en Sciences et Technologies pour l'Environnement et l'Agriculture (IRSTEA).
+Unless otherwise stated, the intellectual property of the content of the pages is held by the Institut national de Recherche en Sciences et Technologies pour l'Environnement et l'Agriculture (IRSTEA).
 
-## Limitation de responsabilité
+## Limitation of liability
 
-L'UMR G-EAU s’engage à fournir les moyens nécessaires et raisonnables pour assurer ou faire assurer un accès continu au site cassiopee.g-eau.fr et à ses contenus pour l’utilisateur.
+The UMR G-EAU undertakes to provide the necessary and reasonable means to ensure or make ensure continuous access to the cassiopee.g-eau.fr website and its contents for the user.
 
-L'UMR G-EAU ne pourra toutefois être tenu pour responsable à l’égard des utilisateurs en cas d’interruption, de défaillance, de défaut éventuel de qualité des services de Cassiopée pour quelque raison que ce soit, y compris pour des raisons de maintenance, d’entretien ou de mise à jour des serveurs.
+However, the UMR G-EAU cannot be held liable to users in the event of interruption, failure or possible lack of quality of Cassiopée's services for any reason whatsoever, including for reasons of maintenance, upkeep or updating of the servers.
 
-Sauf mention contraire, les contenus de Cassiopée sont publiés à titre d’information, à l’exclusion de toute garantie sur leur exactitude ou leur adéquation aux besoins spécifiques des utilisateurs du site cassiopee.g-eau.fr. Les contenus de Cassiopée n’engagent en aucun cas la responsabilité des producteurs en cas de dommage direct ou indirect découlant de leur non-conformité à la réalité du terrain.
+Unless otherwise stated, the contents of Cassiopee are published for information purposes only, excluding any guarantee as to their accuracy or suitability for the specific needs of users of the site cassiopee.g-eau.fr. The contents of Cassiopée do not in any way engage the responsibility of the producers in the event of direct or indirect damage resulting from their non-conformity with the reality on the ground.
 
-Si vous constatiez une erreur ou une omission dans les outils et contenus de Cassiopée, nous vous remercions de le signaler via la fonction « Signaler un problème » disponible dans le menu principal de Cassiopée.
+If you notice an error or omission in the tools and content of Cassiopée, please report it via the "Report a problem" feature available in the main menu of Cassiopée.
 
-## Informations personnelles des utilisateurs
+## Users' personal information
 
-### Données recueillies par Cassiopée
+#### Data collected by Cassiopée
 
-Le site cassiopee.g-eau.fr ne recueille aucune donnée personnelle sur l'utilisateur hormis l'adresse IP de la machine utilisée pour se connecter sur le site.
+The cassiopee.g-eau.fr site does not collect any personal data about the user except the IP address of the machine used to connect to the site.
 
-Les données et les calculs effectués par Cassiopée sont entièrement réalisés sur la machine de l'utilisateur et ne sont transmis ni à l'hébergeur, ni à aucun autre tiers.
+The data and calculations carried out by Cassiopée are entirely carried out on the user's machine and are not transmitted to the server or any other third party.
 
-La soumission d'un rapport de bug via la fonction « Signaler un problème » invite l'utilisateur à transmettre par mail le contenu de sa session de travail en cours à l'équipe de développement de Cassiopée. L'utilisateur peut choisir de ne pas transmettre sa session en supprimant le texte du mail situé sous la ligne `--- État de la session en cours - ne pas modifier le texte ci-dessous ---`. L'adresse électronique transmise par l'utilisateur à l'équipe de développement ne sera en aucun cas transmis à des tiers ou utilisé à d'autres fins que pour contacter l'utilisateur dans le cadre du problème signalé.
+Submitting a bug report via the "Report a problem" feature invites the user to send by email the content of his current work session to the Cassiopée development team. The user can choose not to transmit his session by deleting the text of the email below the line `--- Status of the current session - do not modify the text below ---`. The email address provided by the user to the development team will not be shared with third parties or used for any purpose other than to contact the user in connection with the reported problem.
 
-### Données stockées sur le terminal de l'utilisateur
+#### Data stored on the user's terminal
 
-Cassiopée ne stocke aucune information sur le terminal de l'utilisateur hormis les paramètres de l'application si ceux-ci sont explicitement sauvegardés par l'utilisateur.
+Cassiopée does not store any information on the user's terminal except the application settings if they are explicitly saved by the user.
 
-Tout ou partie de la session de travail de l'utilisateur peut être enregistrée par l'utilisateur sur tout support à sa convenance (fichier au format json) et rechargé ensuite pour un usage ultérieur.
+All or part of the user's working session can be saved by the user on any medium at his convenience (json file) and then loaded for later use.
 
-## Liens hypertextes
+## Hypertext links
 
-### Liens de cassiopee.g-eau.fr vers d’autres sites
+#### Links from cassiopee.g-eau.fr to other sites
 
-Les liens insérés dans les pages du site cassiopee.g-eau.fr vers des sites tiers sont proposés à titre d’information&nbsp;; le contenu des sites vers lesquels ces liens conduisent n’engage pas la responsabilité de l’UMR G-EAU.
+The links inserted in the pages of the site cassiopee.g-eau.fr to third party sites are provided for information purposes only. The content of the sites at which these links point does not engage the responsibility of the UMR G-EAU.
 
-### Établir un lien vers cassiopee.g-eau.fr
+#### Link to cassiopee.g-eau.fr
 
-L’établissement d’un hyperlien vers Cassiopée est libre et gratuit à la condition que cet hyperlien permette l’ouverture d’une nouvelle fenêtre de visualisation et que l’affichage de l’URL cassiopee.g-eau.fr dans la nouvelle fenêtre soit lisible par l’internaute dès son ouverture et tout au long de l’accès aux données de Cassiopée.
+The establishment of a hyperlink to Cassiopée is free and open on condition that this hyperlink allows the opening of a new viewing window and that the display of the URL cassiopee.g-eau.fr in the new window is readable by the Internet user as soon as it is opened and throughout the access to Cassiopée's data.
 
-L’UMR G-EAU se réserve le droit de faire supprimer un hyperlien vers Cassiopée qui serait de nature à nuire à sa politique éditoriale ou à porter atteinte à son image.
+UMR G-EAU reserves the right to delete any hyperlink to Cassiopée that may harm its editorial policy or its image.
 
-## Marques et logotypes
+## Brands and logos
 
-Les marques et logotypes figurant sur le site permettent d’informer quant à l’origine des données et des logiciels utilisés&nbsp;; elles n’ont aucun caractère publicitaire et sont propriété de leurs détenteurs respectifs.
+The brands and logos appearing on the site make it possible to inform as to the origin of the data and software used; they have no advertising character and are the property of their respective owners.
 
-## Copies d’écran et impressions
+## Screenshots and prints
 
-Les contenus produits par Cassiopée (Résultats de calculs, tableaux, graphiques...) sont réutilisables et diffusable sur tout support sans aucune limitation.
+The content produced by Cassiopée (calculation results, tables, graphs, etc.) can be reused and distributed on any medium without any limitation.
 
-La documentation de Cassiopée est publiée sous [Licence CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode.fr) qui autorise à copier, distribuer, communiquer tout ou partie de la documentation par tous moyens et tous formats à condition de la créditer, d'intégrer un lien vers la licence, de ne pas en faire un usage commercial, et de ne pas l'avoir modifiée.
+Cassiopée's documentation is published under[CC BY-NC-ND 4.0 License](https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode.fr) which authorizes to copy, distribute, communicate all or part of the documentation by any means and in any format provided that it is credited, that a link to the license is included, that it is not used commercially, and that it is not modified.
 
-## Logiciels libres
+## Free software
 
-### Licence du module de calcul de Cassiopée
+#### License of the Cassiopée calculation module
 
-Cassiopée est basé sur une bibliothèque nommée JaLHyd (pour JAvascript Library for HYDraulics) développée en Typescript par l'équipe de développement de Cassiopée. Cette bibliothèque est publiée sous [licence GNU AGPL 3](https://www.gnu.org/licenses/agpl.html) et le code source est disponible sur simple demande à l'éditeur de Cassiopée.
+Cassiopée is based on a library called JaLHyd (for JAvascript Library for HYDraulics) developed in Typescript by the Cassiopée development team. This library is published under [GNU AGPL 3 license](https://www.gnu.org/licenses/agpl.html) and the source code is available on request from the Cassiopée editor.
 
-### Outils et bibliothèques tiers
+#### Third-party tools and libraries
 
-Cassiopée a été développé à l'aide de nombreuses bibliothèques et outils du libre dont:
+Cassiopée has been developed using many libraries and free software tools including:
 
 - [Typescript](https://github.com/Microsoft/TypeScript)
 - [Visual Studio Code](https://github.com/Microsoft/vscode)
diff --git a/docs-fr/general/parametres_application.md b/docs-fr/general/parametres_application.md
index 0b3d8453d..cd57d9e40 100644
--- a/docs-fr/general/parametres_application.md
+++ b/docs-fr/general/parametres_application.md
@@ -6,7 +6,7 @@ Accessible depuis le menu latéral gauche, les paramètres de l'application modi
 - Précision de calcul&nbsp;: 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))&nbsp;;
 - Nombre d'itération de l'algorithme de Newton&nbsp;;
 - Activer les notifications à l'écran&nbsp;: autorise l'affichage de notifications lors de certaines opérations (avertissement au chargement d'une session, invalidation de calcul...)&nbsp;;
-- Activer les raccourcis clavier: autorise l'utilisation des raccourcis clavier (Voir liste des raccourcis disponibles)&nbsp;;
-- Langue&nbsp;: définit la langue des interfaces du logiciel en français ou en anglais (N.B.&nbsp;: la documentation n'existe qu'en français).
+- Activer les raccourcis clavier: autorise l'utilisation des raccourcis clavier (Voir [liste des raccourcis disponibles](raccourcis_clavier))&nbsp;;
+- Langue&nbsp;: définit la langue des interfaces du logiciel en français ou en anglais.
 
 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 370800c4c..0d597365a 100644
--- a/docs-fr/general/principe_fonctionnement.md
+++ b/docs-fr/general/principe_fonctionnement.md
@@ -28,7 +28,7 @@ L'interface est conçue pour qu'un paramètre et un seul soit choisi pour le cal
 
 Une série de calculs peut être lancée entre une valeur min et une valeur max pour un pas donné&nbsp;:
 
-![Définition des valeurs mni, max et du pas pour un paramètre à varier](principe_fonctionnement_varie_pas.png)
+![Définition des valeurs min, max et du pas pour un paramètre à varier](principe_fonctionnement_varie_pas.png)
 
 Ou pour une liste de valeurs définies&nbsp;:
 
diff --git a/mkdocs-en.yml b/mkdocs-en.yml
index f01c3c5aa..37030ef85 100644
--- a/mkdocs-en.yml
+++ b/mkdocs-en.yml
@@ -1,4 +1,4 @@
-site_name: Documentation de Cassiopée
+site_name: Cassiopée documentation
 site_author: UMR G-EAU
 docs_dir: docs-en
 site_dir: src/assets/docs-en/
@@ -17,27 +17,27 @@ markdown_extensions:
     - footnotes
     - codehilite
 nav:
-    - avant-propos.md
-    - Présentation de Cassiopée:
+    - Foreword: avant-propos.md
+    - Presentation of Cassiopée:
         - index.md
         - general/principe_fonctionnement.md
         - general/parametres_application.md
         - general/raccourcis_clavier.md
-    - Hydraulique en charge:
+    - Pipe flow:
         - calculators/hyd_en_charge/lechapt-calmon.md
         - calculators/hyd_en_charge/cond_distri.md
-    - Hydraulique à surface libre:
-        - Régime uniforme: calculators/hsl/regime_uniforme.md
+    - Open-channel flow:
+        - Uniform flow: calculators/hsl/regime_uniforme.md
         - calculators/hsl/courbe_remous.md
         - calculators/hsl/section_parametree.md
         - calculators/hsl/pente.md
         - calculators/hsl/types_sections.md
         - calculators/hsl/var_hydrauliques.md
-    - Lois d'ouvrages:
+    - Parallel structures:
         - calculators/structures/lois_ouvrages.md
         - calculators/structures/dever.md
-        - Cloisons: calculators/pab/cloisons.md
-        - Equations d'ouvrages:
+        - Walls: calculators/pab/cloisons.md
+        - Device equations:
             - calculators/structures/kivi.md
             - calculators/structures/orifice_noye.md
             - calculators/structures/orifice_denoye.md
@@ -47,25 +47,25 @@ nav:
             - calculators/structures/dever_triang_tronque.md
             - calculators/structures/cem_88_v.md
             - calculators/structures/cem_88_d.md
-    - Passes à bassins:
-        - Chute: calculators/pab/chute.md
-        - Nombre de chutes: calculators/pab/nombre.md
-        - Puissance dissipée: calculators/pab/volume.md
+    - Fish ladders:
+        - Fall: calculators/pab/chute.md
+        - Number of falls: calculators/pab/nombre.md
+        - Dissipated power: calculators/pab/volume.md
         - Dimensions: calculators/pab/dimensions.md
-        - Cloisons: calculators/pab/cloisons.md
-        - Passe à bassins: calculators/pab/pab.md
-    - Passes à macro-rugosité:
+        - Walls: calculators/pab/cloisons.md
+        - Fish ladder: calculators/pab/pab.md
+    - Rock-ramp fishpasses:
         - calculators/pam/macrorugo.md
         - calculators/pam/macrorugo_theorie.md
         - calculators/pam/macrorugo_complexe.md
-    - Dévalaison:
-        - Perte de charge sur grille de prise d'eau: calculators/devalaison/grille.md
-        - Impact de jet: calculators/devalaison/jet.md
-    - Méthodes numériques de résolution :
+    - Downstream migration:
+        - Loss of charge, water grid: calculators/devalaison/grille.md
+        - Jet impact: calculators/devalaison/jet.md
+    - Numerical methods:
         - Runge-Kutta 4: methodes_numeriques/rk4.md
-        - Euler explicite: methodes_numeriques/euler_explicite.md
-        - Intégration de trapèzes: methodes_numeriques/integration_trapezes.md
-        - Méthode de Brent: methodes_numeriques/brent.md
-        - Méthode de Newton: methodes_numeriques/newton.md
+        - Euler explicit: methodes_numeriques/euler_explicite.md
+        - Trapezes integration: methodes_numeriques/integration_trapezes.md
+        - Brent method: methodes_numeriques/brent.md
+        - Newton method: methodes_numeriques/newton.md
     - CHANGELOG.md
     - mentions_legales.md
-- 
GitLab