diff --git a/doc/classes/String.xml b/doc/classes/String.xml
index a33a1aea41..59733e9696 100644
--- a/doc/classes/String.xml
+++ b/doc/classes/String.xml
@@ -747,7 +747,7 @@
 		<method name="reverse" qualifiers="const">
 			<return type="String" />
 			<description>
-				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.
 			</description>
 		</method>
 		<method name="rfind" qualifiers="const">
diff --git a/doc/classes/StringName.xml b/doc/classes/StringName.xml
index e837b65199..e3c254fb48 100644
--- a/doc/classes/StringName.xml
+++ b/doc/classes/StringName.xml
@@ -648,7 +648,7 @@
 		<method name="reverse" qualifiers="const">
 			<return type="String" />
 			<description>
-				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.
 			</description>
 		</method>
 		<method name="rfind" qualifiers="const">