diff --git a/lib/state_machine/integrations/active_record.rb b/lib/state_machine/integrations/active_record.rb
index bb19f09c..840577c7 100644
--- a/lib/state_machine/integrations/active_record.rb
+++ b/lib/state_machine/integrations/active_record.rb
@@ -35,6 +35,10 @@ module Integrations #:nodoc:
     #   vehicle.ignite                    # => true
     #   vehicle.reload                    # => #<Vehicle id: 1, name: "Ford Explorer", state: "idling">
     # 
+    # *Note* that if you want a transition to update additional attributes of the record, 
+    # either the changes need to be made in a +before_transition+ callback or you need 
+    # to save the record manually.
+    #
     # == Events
     # 
     # As described in StateMachine::InstanceMethods#state_machine, event