diff --git a/doc/classes/Resource.xml b/doc/classes/Resource.xml
index 1ce2c376dd0..54984b77853 100644
--- a/doc/classes/Resource.xml
+++ b/doc/classes/Resource.xml
@@ -76,6 +76,7 @@
 		<signal name="changed">
 			<description>
 				Emitted whenever the resource changes.
+				[b]Note:[/b] This signal is not emitted automatically for custom resources, which means that you need to create a setter and emit the signal yourself.
 			</description>
 		</signal>
 	</signals>