diff --git a/doc/classes/Control.xml b/doc/classes/Control.xml
index 27637b655..8ca8a7a65 100644
--- a/doc/classes/Control.xml
+++ b/doc/classes/Control.xml
@@ -344,6 +344,7 @@
 			<return type="void" />
 			<description>
 				Steal the focus from another control and become the focused control (see [member focus_mode]).
+				[b]Note[/b]: Using this method together with [method Object.call_deferred] makes it more reliable, especially when called inside [method Node._ready].
 			</description>
 		</method>
 		<method name="has_focus" qualifiers="const">