diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 53e03925e5a..fc22d699109 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -13149,6 +13149,24 @@ table2-mapping
+
+ The .** accessor can lead to surprising results
+ when using the lax mode. For instance, the following query selects every
+ HR value twice:
+
+lax $.**.HR
+
+ This happens because the .** accessor selects both
+ the segments array and each of its elements, while
+ the .HR accessor automatically unwraps arrays when
+ using the lax mode. To avoid surprising results, we recommend using
+ the .** accessor only in the strict mode. The
+ following query selects each HR value just once:
+
+strict $.**.HR
+
+
+