diff --git a/docs/en/calculators/devalaison/grille.md b/docs/en/calculators/devalaison/grille.md
index 408a0cdd6776e418325dd5daa602e480d95394dc..2740cd2322f6a6d16277d963513e3e9f3f0285fd 100644
--- a/docs/en/calculators/devalaison/grille.md
+++ b/docs/en/calculators/devalaison/grille.md
@@ -9,7 +9,8 @@ and the intake width \(B\) upstream the trashrack:
 
 $$ V_1 = \frac{Q}{H_1 \times B} $$
 
-The calculation of the head loss coefficient \(\xi\) is based on the characteristics of the trashrack. For a full description of the assumptions, formulas and limitations of the method, please refer to the Raynal et al. (2012) report available here (in French): https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
+The calculation of the head loss coefficient \(\xi\) is based on the characteristics of the trashrack.
+For a full description of the assumptions, formulas and limitations of the method, please refer to the Raynal et al. (2012) report.
 
 
 <div style="position: relative"><a id="grille-conventionnelle" style="position: absolute; top: -60px;"></a></div>
@@ -229,10 +230,10 @@ For example, 1.79 for cylindrical spacers, 2.42 for rectangular spacers, and aro
 
 ## References
 
-Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2012. Définition de prises d’eau ichtyocompatibles -Pertes de charge au passage des plans de grille inclinés ou orientés dans des configurations ichtyocompatibles et champs de vitesse à leur approche (POLE RA11.02). https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
+Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2012. Définition de prises d’eau ichtyocompatibles -Pertes de charge au passage des plans de grille inclinés ou orientés dans des configurations ichtyocompatibles et champs de vitesse à leur approche (POLE RA11.02). [https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf](https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf)
 
-Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. https://doi.org/10.1080/00221686.2012.753647
+Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. [https://doi.org/10.1080/00221686.2012.753647](https://doi.org/10.1080/00221686.2012.753647)
 
-Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. https://doi.org/10.1080/00221686.2012.753646
+Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. [https://doi.org/10.1080/00221686.2012.753646](https://doi.org/10.1080/00221686.2012.753646)
 
-Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. https://doi.org/10.3390/w12040966
+Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. [https://doi.org/10.3390/w12040966](https://doi.org/10.3390/w12040966)
diff --git a/docs/en/calculators/devalaison/jet.md b/docs/en/calculators/devalaison/jet.md
index 02a37c2c685ea831fcbbefe791406e5636f2e391..e67d0cea9f1c86f1a84c061e415df5165ab81a8e 100644
--- a/docs/en/calculators/devalaison/jet.md
+++ b/docs/en/calculators/devalaison/jet.md
@@ -14,7 +14,7 @@ The bottom elevation is used to calculate the depth and the depth to fall ratio.
 
 The downstream fish evacuation outlet ends with a device that empties into the plant's tailrace. This module calculates the position and velocity at the point of impact of the free fall or water vein on the surface of the tailrace water taking into account the initial angle and velocity of the jet and the drop height.
 
-Excerpt from Courret, Dominique, and Michel Larinier. Guide for the design of ichthyocompatible water intakes for small hydroelectric power plants, 2008. https://doi.org/10.13140/RG.2.1.2359.1449, p.24:
+Excerpt from Courret and Larinier (2008), p.24:
 
 > Speeds in the structure and at the point of impact in the tailrace must remain below about 10 m/s, with some organizations even recommending that they not exceed 7-8 m/s (ASCE 1995). (...) The head between the outlet and the water body must not exceed a dozen metres to avoid any risk of injury to fish on impact, whatever their size and mode of fall (free fall or fall in the water vein) (Larinier and Travade 2002). The discharge must also be made in an area of sufficient depth to avoid any risk of injury from mechanical shock. Odeh and Orvis (1998) recommend a minimum depth of about a quarter of the fall, with a minimum of about 1 m.
 
@@ -51,3 +51,7 @@ $$V_z = V_0 \sin \alpha - t * g$$
 ### Speed at impact
 
 $$V_t = \sqrt{ V_x^{2} + V_z^{2} }$$
+
+## References
+
+Courret, Dominique, and Michel Larinier. Guide for the design of ichthyocompatible water intakes for small hydroelectric power plants, 2008. [https://doi.org/10.13140/RG.2.1.2359.1449](https://doi.org/10.13140/RG.2.1.2359.1449)
diff --git a/docs/en/calculators/pab/passe_rangees_periodiques.md b/docs/en/calculators/pab/passe_rangees_periodiques.md
index 05848aa928ca4d63eb14fe0142b10e523f7c4e8a..4c59a919ab5a93d536ab53735591eb9e5040ff7d 100644
--- a/docs/en/calculators/pab/passe_rangees_periodiques.md
+++ b/docs/en/calculators/pab/passe_rangees_periodiques.md
@@ -1,8 +1,8 @@
 # Nature-like fish passage with riprap in periodic rows
 
 It is stated on p.16 of the design guide for nature-like fishways
-(Larinier et al., 2006)[^passe_rangees_periodiques1] that rock-rigged fishways
-in periodic rows are similar to fish ladders, and their design criteria are identical to those of.
+(Larinier et al., 2006) that rock-rigged fishways in periodic rows are similar
+to fish ladders, and their design criteria are identical to those of.
 
 It is therefore possible to use the various tools in the "[fish ladder](pab.md)" module
 module to design this type of device.
@@ -30,5 +30,6 @@ with, for example, overflows from the weir to different basins in the system
 
 An example of a pass can be accessed directly via [this link](https://cassiopee.g-eau.fr/#/loadsession/app%2Fexamples%2Fpasse_rangees_periodiques.json).
 
+## References
 
-[^passe_rangees_periodiques1]: Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/en/calculators/pam/concentration.md b/docs/en/calculators/pam/concentration.md
index 127f6d1dc961274032cd8ecaa1aa1c9cd452bea4..28a31f85a2cdd6c0a51998f5ecd5755016788f6e 100644
--- a/docs/en/calculators/pam/concentration.md
+++ b/docs/en/calculators/pam/concentration.md
@@ -37,4 +37,4 @@ Tolerance is of the order of a centimetre.
 
 ## References
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/en/calculators/pam/macrorugo.md b/docs/en/calculators/pam/macrorugo.md
index fe107c2a0ebd002bd0b96ed2d772134ab651bb0f..95a19ea7d467c5d4f0868221352c00c3bac3524b 100644
--- a/docs/en/calculators/pam/macrorugo.md
+++ b/docs/en/calculators/pam/macrorugo.md
@@ -28,6 +28,6 @@ It requires the following values to be entered:
 
 ![](schema_rugosite_fond.png)
 
-## references
+## References
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Technical guide for the design of "natural" fish passes, GHAPPE RA Report. Compagnie Nationale du Rhône / Adour Garonne Water Agency. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/en/calculators/pam/macrorugo_theorie.md b/docs/en/calculators/pam/macrorugo_theorie.md
index 197eef6463e20419be8c9bde77dbafc43d1667d8..eda7a67dc9c8483f9e73f3f65190331369c14b57 100644
--- a/docs/en/calculators/pam/macrorugo_theorie.md
+++ b/docs/en/calculators/pam/macrorugo_theorie.md
@@ -234,12 +234,12 @@ $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 
 ## References
 
-Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. https://doi.org/10.1051/kmae/2016032
+Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. [https://doi.org/10.1051/kmae/2016032](https://doi.org/10.1051/kmae/2016032)
 
-Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910
+Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. [https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910](https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910)
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
 
-Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)
+Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. [https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)](https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179))
 
-Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. https://doi.org/10.1007/s10652-015-9430-3
+Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. [https://doi.org/10.1007/s10652-015-9430-3](https://doi.org/10.1007/s10652-015-9430-3)
diff --git a/docs/en/calculators/pam/rugofond.md b/docs/en/calculators/pam/rugofond.md
index 8036216fc1dbcc85c332be3295d2d03eb4d3aede..813133559b9e27e956bb91fd9fd87eb7af7e77f9 100644
--- a/docs/en/calculators/pam/rugofond.md
+++ b/docs/en/calculators/pam/rugofond.md
@@ -32,7 +32,7 @@ flow slices".
 ### Relationship between upstream head on the crest and flow rate
 
 The relationship between the upstream load and the flow is represented by a [formula of
-free weir].(../structures/seuil_denoye.md).
+free weir](../structures/seuil_denoye.md).
 
 ### Relationship between water depth, flow velocity and uniform flow
 
@@ -56,9 +56,9 @@ With \(a\) the **Strickler correction coefficient** function of how the riprap i
 
 Larinier, M., J. Chorda, et O. Ferlin. 1995. « Le franchissement des seuils en
 enrochements par les poissons migrateurs : étude expérimentale ». GHAAPPE
-95/05-HYDRE 161. irstea. https://hal.inrae.fr/hal-02575575.
+95/05-HYDRE 161. irstea. [https://hal.inrae.fr/hal-02575575](https://hal.inrae.fr/hal-02575575)
 
 Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique
 pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA.
 Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne.
-http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+[http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/en/calculators/structures/cem_88_d.md b/docs/en/calculators/structures/cem_88_d.md
index 84de84900dc111f10000437fbbf25d59249b49d3..eadb4ebd1d7150719e20a65e0900fec350eb373d 100644
--- a/docs/en/calculators/structures/cem_88_d.md
+++ b/docs/en/calculators/structures/cem_88_d.md
@@ -55,7 +55,7 @@ $$Q = \mu' L \sqrt{2g} (h_1-h_2)^{1/2} \left[ h_2 - (h_2 - W) \right] \Rightarro
 
 Classical formulation of submerged orifices, with \(\mu' = \mu_S\).
 
-Orifice weir operation is represented by the equations above and Figure 19. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to the conventional free orifice formulation:
+Orifice weir operation is represented by the equations above and Figure below. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to the conventional free orifice formulation:
 
 \(C_F = \frac{Q}{L \sqrt{2g} W (h_1 - 0.5 W)^{1/2}}\)
 
@@ -67,4 +67,6 @@ Orifice weir operation is represented by the equations above and Figure 19. Rega
  * (16) : Orifice - totally submerged
  * (14) : Orifice - free flow
 
-Figure 19. Weir - Orifice
+## References
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
diff --git a/docs/en/calculators/structures/cem_88_v.md b/docs/en/calculators/structures/cem_88_v.md
index 7565eea7e2eb57cb5bbdbdd808d45a3448c2b184..334198b436a455120dbc11615209651934cb83fa 100644
--- a/docs/en/calculators/structures/cem_88_v.md
+++ b/docs/en/calculators/structures/cem_88_v.md
@@ -62,7 +62,7 @@ with : \(\alpha_1 = 1 - 0.14 \frac{h_2 - W}{W}\)
 
 \((\alpha_1 = \alpha (h_2-W))\)
 
-Weir gate operation is represented by the above equations and Figure 20. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to a conventional free flow gate design:
+Weir gate operation is represented by the above equations and Figure below. Regardless of the type of flow under load, an equivalent free flow coefficient is calculated corresponding to a conventional free flow gate design:
 
 \(C_F = \frac{Q}{L\sqrt{2g} W \sqrt{h_1}}\)
 
@@ -78,4 +78,6 @@ Note: it is possible to obtain \(C_F \neq C_G\), even under free flow conditions
  * (20) : Orifice - totally submerged
  * (18) : Orifice - free flow
 
-Figure 20. Weir - orifice
+## References
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
diff --git a/docs/en/calculators/structures/cunge_80.md b/docs/en/calculators/structures/cunge_80.md
index 6748bf7d7bdd795cc1d73c9478ad5c6fcf44ef5d..70a367e777ea86be7b518abb8ea7d0a17dbc0cf6 100644
--- a/docs/en/calculators/structures/cunge_80.md
+++ b/docs/en/calculators/structures/cunge_80.md
@@ -38,7 +38,7 @@ $$ W \leq Z_2$$
 
 The free flow gate equation uses a fixed contraction coefficient \(C_c\) with:
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
 For all other flow regimes, used equations here are the following as they can be used independently:
 
diff --git a/docs/en/calculators/structures/dever_triang_tronque.md b/docs/en/calculators/structures/dever_triang_tronque.md
index d7aa9ab988e61faabb26a2836de62ee3c72a86f6..ac02ef3f7be3bd9d85b8699d4c0aa5ed9196b6a0 100644
--- a/docs/en/calculators/structures/dever_triang_tronque.md
+++ b/docs/en/calculators/structures/dever_triang_tronque.md
@@ -1,6 +1,8 @@
 # Truncated triangular weir formula
 
-TT1 caracterized by:
+![Diagram of a truncated triangular weir](dever_triang_tronque_schema.jpg)
+
+The truncated triangular weir is characterized by the following parameters:
 
 * \(C_d\): discharge coefficient
 * \(Z_d\): triangle's lower overflow elevation
@@ -9,13 +11,13 @@ TT1 caracterized by:
 
 ## Formula
 
-### for \(Z_{am} \leq Z_t\)
+### for \(Z_1 \leq Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_{am} - Z_d \right )^{2.5}$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_1 - Z_d \right )^{2.5}$$
 
-### for \(Z_{am} > Z_t\)
+### for \(Z_1 > Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_{am} - Z_d \right )^{2.5} - \left ( Z_{am} - Z_t \right )^{2.5} \right )$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_1 - Z_d \right )^{2.5} - \left ( Z_1 - Z_t \right )^{2.5} \right )$$
 
 Thin wall weir: \(C_d\) = 1.37
 
diff --git a/docs/en/calculators/structures/dever_triang_tronque_schema.jpg b/docs/en/calculators/structures/dever_triang_tronque_schema.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1a0c6d9064bcf8abc1a0cd2e4ba9e97921e54387
Binary files /dev/null and b/docs/en/calculators/structures/dever_triang_tronque_schema.jpg differ
diff --git a/docs/en/calculators/structures/liste.md b/docs/en/calculators/structures/liste.md
index 59ee1a21f8f11e4184ebb894651bcca8bf3df1e3..e636e661d245043c3e487e9fc6d49701554bd4b2 100644
--- a/docs/en/calculators/structures/liste.md
+++ b/docs/en/calculators/structures/liste.md
@@ -22,6 +22,23 @@
 
 Table: Stage-discharge equations list
 
+## Relationship between water level and load
+
+Most of the flow laws in this documentation refer to the
+**water level** or to the **head**.
+These two concepts are generally confused because kinetic energy is neglected
+(See the detailed calculation of the load in the tool [‘Free flow weir stage-discharge laws’](dever.md)).
+These quantities correspond to the difference in elevation between the upstream free surface
+\(Z_1\) or downstream \(Z_2\) and the base of the weir \(Z_{d}\).
+
+We then have:
+
+$$ h_1 = Z_1 - Z_{d} $$
+
+and
+
+$$ h_2 = Z_2 - Z_{d} $$
+
 ## Sharp-crested or broad-crested weir?
 
 Extract from CETMEF, 2005. Note on weirs : synthesis of flow laws at the right of weirs and spillways. Centre d'Études Techniques Maritimes Et Fluviales, Compiègne.
diff --git a/docs/en/calculators/structures/seuil_denoye.md b/docs/en/calculators/structures/seuil_denoye.md
index 395b1d86ce85f9a448fd73887b60cb8a1ccc698c..f756f9dc7333f10f4dcaccd22799e49e0f2461f6 100644
--- a/docs/en/calculators/structures/seuil_denoye.md
+++ b/docs/en/calculators/structures/seuil_denoye.md
@@ -2,9 +2,9 @@
 
 The formula is derived from the original formula of Poleni (1717).
 
-In a free flow, the flow rate depends only on the upstream water level \(h_{amont}\):
+In a free flow, the flow rate depends only on the upstream water level \(h_1\):
 
-$$Q = Cd \sqrt{2g} L h_{amont}^{3/2}$$
+$$Q = Cd \sqrt{2g} L h_1^{3/2}$$
 
 With:
 
diff --git a/docs/en/calculators/structures/seuil_noye.md b/docs/en/calculators/structures/seuil_noye.md
index 2fb05939afdd09c8d8d942d86c3779b76c7b5be4..4dc2a70516e62b5b138992aa56986fdf08ee3a0e 100644
--- a/docs/en/calculators/structures/seuil_noye.md
+++ b/docs/en/calculators/structures/seuil_noye.md
@@ -5,9 +5,9 @@
 
 *Excerpt from: Rajaratnam, N., Muralidhar, D., 1969. Flow below deeply submerged rectangular weirs. Journal of Hydraulic Research 7, 355–374.*
 
-In submerged flow, the flow rate depends on the upstream water level \(h_{amont}\) and the downstream water level \(h_{aval}\) (Rajaratnam et al., 1969):
+In submerged flow, the flow rate depends on the upstream water level \(h_1\) and the downstream water level \(h_2\) (Rajaratnam et al., 1969):
 
-$$Q = Cd \sqrt{2g} Lh_{aval} \sqrt{h_{amont}-h_{aval}}$$
+$$Q = Cd \sqrt{2g} Lh_2 \sqrt{h_1-h_2}$$
 
 With:
 
diff --git a/docs/en/calculators/structures/vanne_denoyee.md b/docs/en/calculators/structures/vanne_denoyee.md
index 72dbb3b4fa68fb3120b5e9deac0a0f0a8aecc1ac..0f603a49f41a255653f4d4ddacd62b5af81a8ae8 100644
--- a/docs/en/calculators/structures/vanne_denoyee.md
+++ b/docs/en/calculators/structures/vanne_denoyee.md
@@ -4,17 +4,17 @@
 
 *Excerpt from Baume, J.-P., Belaud, G., Vion, P.-Y., 2013. Hydraulique pour le génie rural, Formations de Master, Mastère Spécialisé, Ingénieur agronome. UMR G-EAU, Irstea, SupAgro Montpellier.*
 
-\(W\) is the gate opening, \(h_{am}\) the upstream water level and \(L\) the date width.
+\(W\) is the gate opening, \(h_1\) the upstream water level and \(L\) the date width.
 The stage-discharge equation of the free flow sluice gate is derived from Bernoulli's load conservation relationship between the upstream side of the valve and the contracted section.
 
 The height \(h_2\) corresponds to the contracted section and is equal to \(C_c W\) where \(C_c\) is the contraction coefficient. The stage-discharge equation is often expressed as a function of a flow coefficient \(C_{d}\) in the form of:
 
-\(Q = C_d L W \sqrt{2g} \sqrt{h_{am}}\)
+\(Q = C_d L W \sqrt{2g} \sqrt{h_1}\)
 
 So we have the relationship between \(C_d\) and \(C_c\) :
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
-Numerous experiments were conducted to evaluate \(C_d\), which varies little around 0.6. As a first approximation, for a low \(W / h_{am}\) (undershot gate, most frequent case), \(C_d\) is close to \(C_c\) and can be chosen equal to 0.6.
+Numerous experiments were conducted to evaluate \(C_d\), which varies little around 0.6. As a first approximation, for a low \(W / h_1\) (undershot gate, most frequent case), \(C_d\) is close to \(C_c\) and can be chosen equal to 0.6.
 
 Discharge coefficients \(C_d\) are given by abacuses, which can be found in specialized books if necessary. They range from 0.5 to 0.6 for a vertical sluice gate, from 0.6 to 0.7 for a radial gate, up to 0.8 for an inclined sluice gate.
diff --git a/docs/en/calculators/structures/vanne_noyee.md b/docs/en/calculators/structures/vanne_noyee.md
index b79759ae4667d4eadbed44a37055f441421b2804..ef5332ecb0b40f95006cf5c24f65c30ec117ad52 100644
--- a/docs/en/calculators/structures/vanne_noyee.md
+++ b/docs/en/calculators/structures/vanne_noyee.md
@@ -6,6 +6,6 @@
 
 ## Submerged sluice gate equation
 
-\(Q = C'_d LW \sqrt{2g}\sqrt{h_{am} - h_{av}}\)
+\(Q = C'_d LW \sqrt{2g}\sqrt{h_1 - h_2}\)
 
 Coefficient \(C'_d\) is around 0.8.
diff --git a/docs/fr/calculators/devalaison/grille.md b/docs/fr/calculators/devalaison/grille.md
index 76094f95f8a5f4650b498b47ab8be8bc73890a14..b4fa00eb5f758f22060df15ee8100f231cbdbb71 100644
--- a/docs/fr/calculators/devalaison/grille.md
+++ b/docs/fr/calculators/devalaison/grille.md
@@ -9,7 +9,8 @@ et de la largeur de la prise d’eau \(B\) à l’amont du plan de grille&nbsp;:
 
 $$ V_1 = \frac{Q}{H_1 \times B} $$
 
-Le calcul du coefficient de pertes de charge \(\xi\) se fait à partir des caractéristiques de la grille. Pour une description complète des hypothèses, des formules et des limitations de la méthode, se référer au rapport de Raynal et al. (2012) disponible ici&nbsp;: https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
+Le calcul du coefficient de pertes de charge \(\xi\) se fait à partir des caractéristiques de la grille.
+Pour une description complète des hypothèses, des formules et des limitations de la méthode, se référer au rapport de Raynal et al. (2012).
 
 ## Grille conventionnelle
 
@@ -216,11 +217,10 @@ A déterminer à partir des plans de la grille.
 Vaut par exemple 1.79 pour les entretoises cylindriques, 2.42 pour les entretoises rectangulaires, et de l'ordre de 4 pour les poutres carrées et IPN.
 
 ## Références
+Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2012. Définition de prises d’eau ichtyocompatibles -Pertes de charge au passage des plans de grille inclinés ou orientés dans des configurations ichtyocompatibles et champs de vitesse à leur approche (POLE RA11.02). [https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf](https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf)
 
-Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2012. Définition de prises d’eau ichtyocompatibles -Pertes de charge au passage des plans de grille inclinés ou orientés dans des configurations ichtyocompatibles et champs de vitesse à leur approche (POLE RA11.02). https://continuite-ecologique.fr/wp-content/uploads/2019/11/2012_014.pdf
+Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. [https://doi.org/10.1080/00221686.2012.753647](https://doi.org/10.1080/00221686.2012.753647)
 
-Raynal, S., Courret, D., Chatellier, L., Larinier, M., David, L., 2013a. An experimental study on fish-friendly trashracks–Part 1. Inclined trashracks. Journal of Hydraulic Research 51, 56–66. https://doi.org/10.1080/00221686.2012.753647
+Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. [https://doi.org/10.1080/00221686.2012.753646](https://doi.org/10.1080/00221686.2012.753646)
 
-Raynal, S., Chatellier, L., Courret, D., Larinier, M., David, L., 2013b. An experimental study on fish-friendly trashracks–Part 2. Angled trashracks. Journal of Hydraulic Research 51, 67–75. https://doi.org/10.1080/00221686.2012.753646
-
-Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. https://doi.org/10.3390/w12040966
+Lemkecher, F., Chatellier, L., Courret, D., David, L., 2020. Contribution of Different Elements of Inclined Trash Racks to Head Losses Modeling. Water 12, 966. [https://doi.org/10.3390/w12040966](https://doi.org/10.3390/w12040966)
diff --git a/docs/fr/calculators/devalaison/jet.md b/docs/fr/calculators/devalaison/jet.md
index 22fcdaf401941e1d9bc7ba923b7a4c036276eb9a..f7618020361ac987385046ec8349090a6ff74945 100644
--- a/docs/fr/calculators/devalaison/jet.md
+++ b/docs/fr/calculators/devalaison/jet.md
@@ -14,7 +14,7 @@ La cote du fond est utilisée pour calculer la profondeur et le rapport profonde
 
 L'exutoire d'évacuation des poissons vers l'aval se termine par un dispositif se jetant dans le canal de fuite de la centrale. Le présent module permet de calculer la position et la vitesse au point d'impact de la chute libre ou de la veine d'eau à la surface de l'eau du canal de fuite compte tenu de l'angle et de la vitesse initiaux du jet et de la hauteur de chute.
 
-Extrait de Courret, Dominique, et Michel Larinier. Guide pour la conception de prise d’eau ichtyocompatibles pour les petites centrales hydroélectriques, 2008. https://doi.org/10.13140/RG.2.1.2359.1449, p.24&nbsp;:
+Extrait de Courret et Larinier (2008), p.24&nbsp;:
 
 > Les vitesses dans l’ouvrage et au point d’impact dans le bief aval doivent rester inférieures à une dizaine de m/s, certains organismes préconisant même de ne pas dépasser 7-8 m/s (ASCE 1995). (...) La hauteur de chute entre le débouché et le plan d’eau ne doit pas dépasser une douzaine de mètres pour éviter tout risque de blessures des poissons à l’impact, quels que soient leur taille et leur mode de chute (chute libre ou chute dans la veine d’eau) (Larinier et Travade 2002). Le rejet doit également se faire dans une zone d’une profondeur suffisante pour éviter tout risque de blessure par choc mécanique. Odeh et Orvis (1998) préconisent une profondeur minimale de l’ordre du quart de la chute, avec un minimum d’environ 1 m.
 
@@ -51,3 +51,7 @@ $$V_z = V_0 \sin \alpha - t * g$$
 ### Vitesse à l'impact
 
 $$V_t = \sqrt{ V_x^{2} + V_z^{2} }$$
+
+## Références
+
+Courret, Dominique, et Michel Larinier. Guide pour la conception de prise d’eau ichtyocompatibles pour les petites centrales hydroélectriques, 2008. [https://doi.org/10.13140/RG.2.1.2359.1449](https://doi.org/10.13140/RG.2.1.2359.1449)
\ No newline at end of file
diff --git a/docs/fr/calculators/pab/passe_rangees_periodiques.md b/docs/fr/calculators/pab/passe_rangees_periodiques.md
index 017dbb0c8be86990cc73ca67b73ab5b53beb61d9..e1d87fb2a06b019a41a3df52ad504b972d8c5c19 100644
--- a/docs/fr/calculators/pab/passe_rangees_periodiques.md
+++ b/docs/fr/calculators/pab/passe_rangees_periodiques.md
@@ -32,4 +32,4 @@ avec par exemple des déversés du seuil vers différents bassins du dispositif
 Un exemple de passe est directement accessible via [ce lien](https://cassiopee.g-eau.fr/#/loadsession/app%2Fexamples%2Fpasse_rangees_periodiques.json).
 
 
-[^passe_rangees_periodiques1]: Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+[^passe_rangees_periodiques1]: Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [https://dx.doi.org/10.13140/RG.2.1.1834.8562](https://dx.doi.org/10.13140/RG.2.1.1834.8562).
diff --git a/docs/fr/calculators/pam/concentration.md b/docs/fr/calculators/pam/concentration.md
index 0f73795ea3813cc669215dc76cb669a4906eb51d..10e7425572260dadc8a3fbaaa50f7244b29ce594 100644
--- a/docs/fr/calculators/pam/concentration.md
+++ b/docs/fr/calculators/pam/concentration.md
@@ -37,4 +37,4 @@ La tolérance est de l'ordre du centimètre.
 
 ## Références
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [https://dx.doi.org/10.13140/RG.2.1.1834.8562](https://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/fr/calculators/pam/macrorugo.md b/docs/fr/calculators/pam/macrorugo.md
index fa963b0196893a6e4cc92646a377f65ba6cef7ee..434cd0270ad95b81e3ba4b93a3683d59500e51c7 100644
--- a/docs/fr/calculators/pam/macrorugo.md
+++ b/docs/fr/calculators/pam/macrorugo.md
@@ -29,4 +29,4 @@ Il nécessite d'entrer les valeurs suivantes&nbsp;:
 
 ## Références
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
diff --git a/docs/fr/calculators/pam/macrorugo_theorie.md b/docs/fr/calculators/pam/macrorugo_theorie.md
index f1bb2c4617e772a7fc02845011192d2d1cd091c6..4cea24b9011ec97d189b27a5b2a5c4671d22f92d 100644
--- a/docs/fr/calculators/pam/macrorugo_theorie.md
+++ b/docs/fr/calculators/pam/macrorugo_theorie.md
@@ -231,12 +231,12 @@ $$C_f = \frac{2}{(5.1 \mathrm{log} (h/k_s)+6)^2}$$
 
 ## Références
 
-Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. https://doi.org/10.1051/kmae/2016032
+Cassan L, Laurens P. 2016. Design of emergent and submerged rock-ramp fish passes. Knowl. Manag. Aquat. Ecosyst., 417, 45. [https://doi.org/10.1051/kmae/2016032](https://doi.org/10.1051/kmae/2016032)
 
-Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910
+Cassan, L., Tien, T.D., Courret, D., Laurens, P., Dartus, D., 2014. Hydraulic Resistance of Emergent Macroroughness at Large Froude Numbers: Design of Nature-Like Fishpasses. Journal of Hydraulic Engineering 140, 04014043. [https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910](https://doi.org/10.1061/(ASCE)HY.1943-7900.0000910)
 
-Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. http://dx.doi.org/10.13140/RG.2.1.1834.8562
+Larinier, Michel, Courret, D., Gomes, P., 2006. Guide technique pour la conception des passes à poissons “naturelles,” Rapport GHAPPE RA. Compagnie Nationale du Rhône / Agence de l’Eau Adour Garonne. [http://dx.doi.org/10.13140/RG.2.1.1834.8562](http://dx.doi.org/10.13140/RG.2.1.1834.8562)
 
-Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)
+Rice C. E., Kadavy K. C., et Robinson K. M., 1998. Roughness of Loose Rock Riprap on Steep Slopes. Journal of Hydraulic Engineering 124, 179-85. [https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179)](https://doi.org/10.1061/(ASCE)0733-9429(1998)124:2(179))
 
-Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. https://doi.org/10.1007/s10652-015-9430-3
+Tran, T.D., Chorda, J., Laurens, P., Cassan, L., 2016. Modelling nature-like fishway flow around unsubmerged obstacles using a 2D shallow water model. Environmental Fluid Mechanics 16, 413–428. [https://doi.org/10.1007/s10652-015-9430-3](https://doi.org/10.1007/s10652-015-9430-3)
diff --git a/docs/fr/calculators/pam/rugofond.md b/docs/fr/calculators/pam/rugofond.md
index 79ed896d17447b8da3ddb04aa0ed5169fdbd7fbc..89233612cadaed6ae61c0a527761263ad175ae76 100644
--- a/docs/fr/calculators/pam/rugofond.md
+++ b/docs/fr/calculators/pam/rugofond.md
@@ -61,9 +61,9 @@ de leur niveau de jointement (Larinier et al., 2006):
 
 Larinier, M., J. Chorda, et O. Ferlin. 1995. « Le franchissement des seuils en
 enrochements par les poissons migrateurs : étude expérimentale ». GHAAPPE
-95/05-HYDRE 161. irstea. https://hal.inrae.fr/hal-02575575.
+95/05-HYDRE 161. irstea. [https://hal.inrae.fr/hal-02575575](https://hal.inrae.fr/hal-02575575).
 
 Larinier, Michel, Dominique Courret, et Peggy Gomes. 2006. « Guide technique
 pour la conception des passes à poissons “naturelles” ». Rapport GHAPPE RA.
 Compagnie Nationale du Rhône / Agence de l'Eau Adour Garonne.
-http://dx.doi.org/10.13140/RG.2.1.1834.8562.
+[https://dx.doi.org/10.13140/RG.2.1.1834.8562](https://dx.doi.org/10.13140/RG.2.1.1834.8562).
diff --git a/docs/fr/calculators/structures/cem_88_d.md b/docs/fr/calculators/structures/cem_88_d.md
index 8f40ee2921e07a252aadc85990b135bb2859658f..18616958235cc432a9a821ba87487db3fc027971 100644
--- a/docs/fr/calculators/structures/cem_88_d.md
+++ b/docs/fr/calculators/structures/cem_88_d.md
@@ -1,8 +1,9 @@
-# CEM88(D) : Déversoir / Orifice (pelle importante)
+# Cemagref-D : Déversoir / Orifice (pelle importante)
 
 ![Schéma CEM 88 D](cem_88_d_schema.jpg)
 
 ## Déversoir - régime dénoyé
+
 (\(h_1 < W et h_2 \leq \frac{2}{3} h_1\))
 
 \(Q = \mu_F L \sqrt{2g} h_1^{3/2}\)
@@ -10,6 +11,7 @@
 Formulation classique du déversoir dénoyé (\(\mu_F \simeq 0.4\)).
 
 ## Déversoir - régime noyé
+
 (\(h_1 < W\) et \(h_2 \geq \frac{2}{3} h_1\))
 
 $$Q = \mu_S L \sqrt{2g} (h_1-h_2)^{1/2} h_2$$
@@ -27,6 +29,7 @@ On peut calculer un coefficient de débit dénoyé équivalent :
 qui permet de juger du degré d’ennoiement du seuil en le comparant au coefficient dénoyé \(\mu_F\) introduit. En effet, le coefficient directeur de l’ouvrage introduit est celui du déversoir dénoyé (\(\mu_F\) proche de \(0.4\)).
 
 ## Orifice - régime dénoyé
+
 (\(h_1 \geq W\) et \(h_2 \leq \frac{2}{3} h_1\))
 
 On prend une formulation du type :
@@ -44,18 +47,20 @@ La continuité vers le fonctionnement à surface libre est assuré quand :
 Il existe deux formulations suivant que l’on est partiellement noyé ou totalement noyé.
 
 ### Régime partiellement noyé
+
 (\(h_1 \geq W\) et \(\frac{2}{3} h_1 < h_2 < \frac{2}{3} h_1 + \frac{W}{3}\))
 
 \(Q = \mu_F L \sqrt{2g} \left[ \frac{3\sqrt{3}}{2} \left( \left( h_1 - h_2 \right)^{1/2} h_2 \right) - \left(h_1 - W \right)^{3/2} \right]\)
 
 ### Régime totalement noyé
+
 (\(h_1 \geq W\) et \(\frac{2}{3} h_1 + \frac{W}{3} < h_2\))
 
 $$Q = \mu' L \sqrt{2g} (h_1-h_2)^{1/2} \left[ h_2 - (h_2 - W) \right] \Rightarrow Q = \mu' L \sqrt{2g} (h_1-h_2)^{1/2} W$$
 
 Formulation classique des orifices noyés, avec \(\mu' = \mu_S\).
 
-Le fonctionnement déversoir orifice est représenté par les équations ci-dessus et la figure 19. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à la formulation classique de l’orifice dénoyé :
+Le fonctionnement déversoir orifice est représenté par les équations ci-dessus et la figure ci-dessous. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à la formulation classique de l’orifice dénoyé :
 
 \(C_F = \frac{Q}{L \sqrt{2g} W (h_1 - 0.5 W)^{1/2}}\)
 
@@ -67,4 +72,6 @@ Le fonctionnement déversoir orifice est représenté par les équations ci-dess
  * (16) : Orifice - totalement noyé
  * (14) : Orifice - dénoyé
 
-Figure 19. Déversoir - Orifice
+## Références
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
diff --git a/docs/fr/calculators/structures/cem_88_v.md b/docs/fr/calculators/structures/cem_88_v.md
index 1dbc77682caa8029e2503cfac8d9d6b3b0a668b4..b53d7652f47b28b66ae96f2947f647f203af6ac2 100644
--- a/docs/fr/calculators/structures/cem_88_v.md
+++ b/docs/fr/calculators/structures/cem_88_v.md
@@ -1,4 +1,4 @@
-# CEM88(V) : Déversoir / Vanne de fond (pelle faible)
+# Cemagref-V : Déversoir / Vanne de fond (pelle faible)
 
 ![Schéma CEM 88 V](cem_88_v_schema.jpg)
 
@@ -62,7 +62,7 @@ avec : \(\alpha_1 = 1 - 0.14 \frac{h_2 - W}{W}\)
 
 \((\alpha_1 = \alpha (h_2-W))\)
 
-Le fonctionnement déversoir-vanne est représenté par les équations ci-dessus et la figure 20. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à une formulation classique de la vanne dénoyée :
+Le fonctionnement déversoir-vanne est représenté par les équations ci-dessus et la figure ci-dessous. Quel que soit le type d’écoulement en charge, on calcule un coefficient de débit dénoyé équivalent correspondant à une formulation classique de la vanne dénoyée :
 
 \(C_F = \frac{Q}{L\sqrt{2g} W \sqrt{h_1}}\)
 
@@ -70,7 +70,7 @@ Le coefficient directeur par défaut pour l’ouvrage est un coefficient \(C_G\)
 
 Remarque : il est possible d’obtenir \(C_F \neq C_G\), même en régime dénoyé, du moment que le coefficient de débit augmente avec le rapport \(\frac{h_1}{W}\).
 
-![Graphique CEM 88 V](cem_88_v_graphique.jpg)
+![Abaque de l'ennoiement pour la formule Cemagref-V](cem_88_v_graphique.jpg)
 
  * (12) : Déversoir - dénoyé
  * (19) : Orifice - partiellement noyé
@@ -78,4 +78,6 @@ Remarque : il est possible d’obtenir \(C_F \neq C_G\), même en régime dénoy
  * (20) : Orifice - totalement noyé
  * (18) : Orifice - dénoyé
 
-Figure 20. Déversoir - orifice
+## Références
+
+Baume, Jean-Pierre. 1988. « Modélisation des ouvrages de type : déversoir, vanne, orifice, dans les modèles d’hydraulique à surface libre ». Montpellier n°205-Document de travail 87.1. Montpellier, France: CEMAGREF. [https://hal.inrae.fr/hal-04970129](https://hal.inrae.fr/hal-04970129)
diff --git a/docs/fr/calculators/structures/cunge_80.md b/docs/fr/calculators/structures/cunge_80.md
index d49de88c7814d47d3b3bd725e4c681bc2a3bc6e5..78d31b377ebef5791d17ff5544f36089773c7c40 100644
--- a/docs/fr/calculators/structures/cunge_80.md
+++ b/docs/fr/calculators/structures/cunge_80.md
@@ -40,7 +40,7 @@ $$ W \leq Z_2$$
 
 L'équation de la vanne dénoyée utilise un coefficient de contraction \(C_c\) fixe avec &nbsp;:
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
 Pour tous les autres régimes d'écoulement les équations utilisées sont les suivantes telles qu'elles peuvent être indépendamment utilsées&nbsp;:
 
diff --git a/docs/fr/calculators/structures/dever_triang_tronque.md b/docs/fr/calculators/structures/dever_triang_tronque.md
index e6542d8ebf4bd0bb918926a8717907d41f3f21ef..493b9e5547421f0203766b5dc9892123d5abf316 100644
--- a/docs/fr/calculators/structures/dever_triang_tronque.md
+++ b/docs/fr/calculators/structures/dever_triang_tronque.md
@@ -1,6 +1,8 @@
 # Formule du déversoir triangulaire tronqué
 
-TT1 caractérisé par&nbsp;:
+![Schéma d'un seuil triangulaire tronqué](dever_triang_tronque_schema.jpg)
+
+Le déversoir triangulaire tronqué est caractérisée par les paramètres suivants&nbsp;:
 
 * \(C_d\)&nbsp;: coefficient de débit
 * \(Z_d\)&nbsp;: cote de déversement basse du triangle
@@ -9,13 +11,13 @@ TT1 caractérisé par&nbsp;:
 
 ## Formule
 
-### pour \(Z_{am} \leq Z_t\)
+### pour \(Z_1 \leq Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_{am} - Z_d \right )^{2.5}$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( Z_1 - Z_d \right )^{2.5}$$
 
-### pour \(Z_{am} > Z_t\)
+### pour \(Z_1 > Z_t\)
 
-$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_{am} - Z_d \right )^{2.5} - \left ( Z_{am} - Z_t \right )^{2.5} \right )$$
+$$Q = C_d \frac{B}{2 (Z_t - Z_d)} \left ( \left ( Z_1 - Z_d \right )^{2.5} - \left ( Z_1 - Z_t \right )^{2.5} \right )$$
 
 Déversoir en mince paroi&nbsp;: \(C_d\) = 1.37
 
diff --git a/docs/fr/calculators/structures/dever_triang_tronque_schema.jpg b/docs/fr/calculators/structures/dever_triang_tronque_schema.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1a0c6d9064bcf8abc1a0cd2e4ba9e97921e54387
Binary files /dev/null and b/docs/fr/calculators/structures/dever_triang_tronque_schema.jpg differ
diff --git a/docs/fr/calculators/structures/liste.md b/docs/fr/calculators/structures/liste.md
index 29f05d56bbc78be5ed740f678f68d67b3ef4bc1a..a7c6feb1e16e7665bc67bc15d5f6502d9011ff40 100644
--- a/docs/fr/calculators/structures/liste.md
+++ b/docs/fr/calculators/structures/liste.md
@@ -22,6 +22,23 @@
 
 Table: Liste des équations d'ouvrages
 
+## Relation entre cote de l'eau et charge
+
+La plupart des lois de débit de cette documentation font référence à la
+**hauteur d'eau** \(h\) ou à la **charge** \(H\).
+Ces deux notions sont généralement confondues car l'énergie cinétique est négligée
+(Voir le détail du calcul de la charge dans l'outil ["Lois de déversoirs dénoyés"](dever.md)).
+Ces grandeurs correspondent à la différence de cote entre la surface libre amont
+\(Z_1\) ou aval \(Z_2\) et la base du seuil déversant \(Z_{d}\).
+
+On a alors:
+
+$$ h_1 = Z_1 - Z_{d} $$
+
+et
+
+$$ h_2 = Z_2 - Z_{d} $$
+
 ## Seuil à crête mince ou crête épaisse ?
 
 Extrait de CETMEF, 2005. Notice sur les déversoirs : synthèse des lois d’écoulement au droit des seuils et déversoirs. Centre d’Études Techniques Maritimes Et Fluviales, Compiègne.
diff --git a/docs/fr/calculators/structures/seuil_denoye.md b/docs/fr/calculators/structures/seuil_denoye.md
index 9923c71419c8764e182b0b7b1937a94985553a82..896951248aa9264d8b8c80e498b920afd84665f2 100644
--- a/docs/fr/calculators/structures/seuil_denoye.md
+++ b/docs/fr/calculators/structures/seuil_denoye.md
@@ -3,9 +3,9 @@
 
 La formule est dérivée de la formule originale de Poleni (1717).
 
-En régime dénoyé, le débit ne dépend que de la hauteur d'eau amont \(h_{amont}\)&nbsp;:
+En régime dénoyé, le débit ne dépend que de la hauteur d'eau amont \(h_1\)&nbsp;:
 
-$$Q = Cd \sqrt{2g} L h_{amont}^{3/2}$$
+$$Q = Cd \sqrt{2g} L h_1^{3/2}$$
 
 Avec&nbsp;:
 
diff --git a/docs/fr/calculators/structures/seuil_noye.md b/docs/fr/calculators/structures/seuil_noye.md
index 37fbfa811dfeaa0174ea1271e8645bd93254c311..4a65ce01d83b9cf76bc15a40f7cc8cf3de368b79 100644
--- a/docs/fr/calculators/structures/seuil_noye.md
+++ b/docs/fr/calculators/structures/seuil_noye.md
@@ -2,16 +2,16 @@
 
 ![Schéma du seuil noyé](seuil_noye_schema.png)
 
-En régime noyé, le débit dépend de la hauteur d'eau amont \(h_{amont}\) et de la hauteur aval \(h_{aval}\) (Rajaratnam et al., 1969)&nbsp;:
+En régime noyé, le débit dépend de la hauteur d'eau amont \(h_1\) et de la hauteur aval \(h_2\) (Rajaratnam et al., 1969)&nbsp;:
 
-$$Q = Cd \sqrt{2g} Lh_{aval} \sqrt{h_{amont}-h_{aval}}$$
+$$Q = Cd \sqrt{2g} Lh_2 \sqrt{h_1-h_2}$$
 
 Avec&nbsp;:
 
-* *L* la largeur du seuil en m&nbsp;
-* *h<sub>amont</sub>* la charge sur le seuil à l'amont en m&nbsp;
-* *h<sub>aval</sub>* la charge sur le seuil à l'aval en m&nbsp;
-* *C<sub>d</sub>* le coefficient de débit (égal à 0.9 par défaut).
+* \(L\) la largeur du seuil en m&nbsp;
+* \(h_1\) la charge sur le seuil à l'amont en m
+* \(h_2\) la charge sur le seuil à l'aval en m&nbsp;
+* \(C_d\) le coefficient de débit (égal à 0.9 par défaut).
 
 Cette formule n'est pas conseillée pour un ennoiement inférieur à 80%.
 
diff --git a/docs/fr/calculators/structures/vanne_denoyee.md b/docs/fr/calculators/structures/vanne_denoyee.md
index 602a94f1f70743dafcbcffdc4ea081c000a5e1c3..63e0e6b34d83e11da820ff49203b6844503d8d08 100644
--- a/docs/fr/calculators/structures/vanne_denoyee.md
+++ b/docs/fr/calculators/structures/vanne_denoyee.md
@@ -4,17 +4,17 @@
 
 *Extrait de Baume, J.-P., Belaud, G., Vion, P.-Y., 2013. Hydraulique pour le génie rural, Formations de Master, Mastère Spécialisé, Ingénieur agronome. UMR G-EAU, Irstea, SupAgro Montpellier.*
 
-\(W\) est l'ouverture de la vanne, \(h_{am}\) la hauteur d'eau à l'amont et \(L\) la largeur de la vanne.
+\(W\) est l'ouverture de la vanne, \(h_1\) la hauteur d'eau à l'amont et \(L\) la largeur de la vanne.
 L'équation de la vanne dénoyée s'obtient à partir de la relation de Bernoulli de conservation de la charge entre l'amont de la vanne et la section contractée.
 
 La hauteur \(h_2\) correspond à la section contractée et est égale à \(C_c W\) où \(C_c\) est le coefficient de contraction. On exprime souvent l'équation de la vanne dénoyée en fonction d'un coefficient de débit sous la forme :
 
-\(Q = C_d L W \sqrt{2g} \sqrt{h_{am}}\)
+\(Q = C_d L W \sqrt{2g} \sqrt{h_1}\)
 
 Ainsi, on a la relation entre \(C_d\) et \(C_c\) :
 
-\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_{am}}}\)
+\(C_d = \frac{C_c}{\sqrt{1 + C_c W / h_1}}\)
 
-De nombreuses expériences ont été faites pour évaluer \(C_d\), qui varie peu autour de 0.6. En première approximation, pour \(W / h_{am}\) faible (vanne de fond, cas le plus classique), \(C_d\) est proche de \(C_c\) et peut être pris égal à 0.6.
+De nombreuses expériences ont été faites pour évaluer \(C_d\), qui varie peu autour de 0.6. En première approximation, pour \(W / h_1\) faible (vanne de fond, cas le plus classique), \(C_d\) est proche de \(C_c\) et peut être pris égal à 0.6.
 
 Les coefficients de débit \(C_d\) sont donnés par des abaques, que l'on trouvera dans des ouvrages spécialisés si besoin. Ils sont de l'ordre de 0.5 à 0.6 pour une vanne verticale, de 0.6 à 0.7 pour une vanne radiale, jusqu'à 0.8 pour une vanne inclinée par rapport à la verticale.
diff --git a/docs/fr/calculators/structures/vanne_noyee.md b/docs/fr/calculators/structures/vanne_noyee.md
index c56bfd02c48ffae4886748f6f6e1be3534dce22e..7ea58ea17ea635ac296cae21cd3f2eb9125663d9 100644
--- a/docs/fr/calculators/structures/vanne_noyee.md
+++ b/docs/fr/calculators/structures/vanne_noyee.md
@@ -6,6 +6,6 @@
 
 ## Équation de la vanne noyée
 
-\(Q = C'_d LW \sqrt{2g}\sqrt{h_{am} - h_{av}}\)
+\(Q = C'_d LW \sqrt{2g}\sqrt{h_1 - h_2}\)
 
 Le coefficient \(C'_d\) est de l'ordre de 0.8.
diff --git a/src/locale/messages.en.json b/src/locale/messages.en.json
index 69a48fd7e1baf297974179fd5e423a7753ffdc7e..86c128dcfe14c5836ee51f1e8c4f0a9e9a962298 100755
--- a/src/locale/messages.en.json
+++ b/src/locale/messages.en.json
@@ -331,8 +331,8 @@
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRBROAD": "Broad-crested weir (Bos)",
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRFREE": "Sharp-crested weir (Villemonte)",
     "INFO_LIB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Sharp-crested weir (Villemonte)",
-    "INFO_LIB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref)",
-    "INFO_LIB_LOIDEBIT_GATECEM88V": "Broad-crested weir / sluice gate (Cemagref)",
+    "INFO_LIB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref-D)",
+    "INFO_LIB_LOIDEBIT_GATECEM88V": "Broad-crested weir / sluice gate (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88D": "Broad-crested weir (Cemagref-D)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88V": "Broad-crested weir (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_CUNGE80": "Broad-crested weir / orifice (Cunge)",
@@ -484,7 +484,7 @@
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRBROAD": "V-notch broad-crested weir (Bos)",
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRFREE": "V-notch sharp-crested weir (Villemonte)",
     "INFO_PAB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Truncated triangular weir (Villemonte)",
-    "INFO_PAB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref)",
+    "INFO_PAB_LOIDEBIT_GATECEM88D": "Broad-crested weir / Orifice (Cemagref-D)",
     "INFO_PAB_LOIDEBIT_VANLEVLARINIER": "Regulated submerged slot (Larinier)",
     "INFO_PAB_LOIDEBIT_VANLEVVILLEMONTE": "Regulated notch (Villemonte)",
     "INFO_PAB_LOIDEBIT_WEIRCEM88D": "Broad-crested weir (Cemagref-D)",
diff --git a/src/locale/messages.fr.json b/src/locale/messages.fr.json
index a7bfbdfd0eb8f3b1cc1c1dd57233a4c17682f329..6dac4cd3cc636e39d1071ef2a724812f95984478 100755
--- a/src/locale/messages.fr.json
+++ b/src/locale/messages.fr.json
@@ -332,8 +332,8 @@
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRBROAD": "Seuil épais (Bos)",
     "INFO_LIB_LOIDEBIT_TRIANGULARWEIRFREE": "Seuil mince (Villemonte)",
     "INFO_LIB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Seuil mince (Villemonte)",
-    "INFO_LIB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref)",
-    "INFO_LIB_LOIDEBIT_GATECEM88V": "Seuil épais / Vanne de fond (Cemagref)",
+    "INFO_LIB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref-D)",
+    "INFO_LIB_LOIDEBIT_GATECEM88V": "Seuil épais / Vanne de fond (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88D": "Seuil épais (Cemagref-D)",
     "INFO_LIB_LOIDEBIT_WEIRCEM88V": "Seuil épais (Cemagref-V)",
     "INFO_LIB_LOIDEBIT_CUNGE80": "Seuil épais / orifice (Cunge)",
@@ -485,7 +485,7 @@
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRBROAD": "Déversoir triangulaire épais (Bos)",
     "INFO_PAB_LOIDEBIT_TRIANGULARWEIRFREE": "Déversoir triangulaire mince (Villemonte)",
     "INFO_PAB_LOIDEBIT_TRIANGULARTRUNCWEIRFREE": "Déversoir triangulaire tronqué (Villemonte)",
-    "INFO_PAB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref)",
+    "INFO_PAB_LOIDEBIT_GATECEM88D": "Seuil épais / Orifice (Cemagref-D)",
     "INFO_PAB_LOIDEBIT_VANLEVLARINIER": "Fente noyée régulée (Larinier)",
     "INFO_PAB_LOIDEBIT_VANLEVVILLEMONTE": "Échancrure régulée (Villemonte)",
     "INFO_PAB_LOIDEBIT_WEIRCEM88D": "Seuil épais (Cemagref-D)",