diff --git a/docs/sphinx/scripting.rst b/docs/sphinx/scripting.rst
index 62c8f3569..df5729255 100644
--- a/docs/sphinx/scripting.rst
+++ b/docs/sphinx/scripting.rst
@@ -122,6 +122,9 @@ without necessarily having to lock scripts/interpreters every frame.
 
     Adds an timer callback which triggers every *milliseconds*.
 
+    Note: Using instance methods as callbacks is not supported. Always
+    use module methods.
+
 .. py:function:: timer_remove(callback)
 
     Removes a timer callback.  (Note: You can also use