diff --git a/doc/python_api/examples/bpy.props.4.py b/doc/python_api/examples/bpy.props.4.py
index 93e4a9fda62..73c314498ed 100644
--- a/doc/python_api/examples/bpy.props.4.py
+++ b/doc/python_api/examples/bpy.props.4.py
@@ -10,6 +10,12 @@ All properties define update functions except for CollectionProperty.
 .. warning::
    Remember that these callbacks may be executed in threaded context.
 
+.. warning::
+   If the property belongs to an Operator, the update callback's first 
+   parameter will be an OperatorProperties instance, rather than an instance 
+   of the operator itself. This means you can't access other internal functions
+   of the operator, only its other properties.
+
 """
 
 import bpy