diff --git a/docs/web/bindings-cxx.md b/docs/web/bindings-cxx.md
index 4aed74405..433504089 100644
--- a/docs/web/bindings-cxx.md
+++ b/docs/web/bindings-cxx.md
@@ -464,6 +464,12 @@ argument of the `ThreadPool` type allowing a parallelization of the
 behaviour integration. The user may refer to the `IntegrateTest2b.cxx`
 file to have an example on how this use this second overload.
 
+> ** Note **
+>
+> The `integrate_debug` function can be used to generate debug files
+> to analyse integration failures. See
+> [this page](behaviour-integration-failure-analysis.html) for details.
+
 # Support for behaviours' initialize functions {#sec:mgis:2.1:initialize_functions}
 
 Since version 4.1, `MFront` behaviours can declare initialize functions
diff --git a/docs/web/release-notes-3.1.md b/docs/web/release-notes-3.1.md
index 7529eb491..c904bf01d 100644
--- a/docs/web/release-notes-3.1.md
+++ b/docs/web/release-notes-3.1.md
@@ -67,6 +67,21 @@ The `MGIS/Function` library is described on [this page](functions.html).
 
 # Improvements
 
+## The `integrate_debug` functions
+
+The `integrate_debug` function can be used to generate debug files to
+analyse integration failures. This function is very customizable, see
+[this page](behaviour-integration-failure-analysis.html) for details.
+
+### Example of usage
+
+This snippet shows that the `integrate_debug` functions can be used as
+drop-in replacement for the `integrate` function.
+
+~~~~{.cxx}
+const auto r = integrate_debug(v, b);
+~~~~
+
 ## `getDatabase` and `loadFromDatabase`
 
 > **Note**