diff --git a/doc/classes/String.xml b/doc/classes/String.xml
index a33a1aea4188..59733e969657 100644
--- a/doc/classes/String.xml
+++ b/doc/classes/String.xml
@@ -747,7 +747,7 @@
- Returns the copy of this string in reverse order.
+ Returns the copy of this string in reverse order. This operation works on unicode codepoints, rather than sequences of codepoints, and may break things like compound letters or emojis.
diff --git a/doc/classes/StringName.xml b/doc/classes/StringName.xml
index e837b65199ce..e3c254fb4865 100644
--- a/doc/classes/StringName.xml
+++ b/doc/classes/StringName.xml
@@ -648,7 +648,7 @@
- Returns the copy of this string in reverse order.
+ Returns the copy of this string in reverse order. This operation works on unicode codepoints, rather than sequences of codepoints, and may break things like compound letters or emojis.