diff --git a/UPGRADE_TO_2_3 b/UPGRADE_TO_2_3
index c0b451f22..28e734a84 100644
--- a/UPGRADE_TO_2_3
+++ b/UPGRADE_TO_2_3
@@ -20,8 +20,8 @@ not when they are set.
 
 Also, related functions were affected:
 
-* execute(ArrayCollection $parameters, $hydrationMode)
-* iterate(ArrayCollection $parameters, $hydrationMode)
-* setParameters(ArrayCollection $parameters)
-* getParameters()
-* getParameter($key)
\ No newline at end of file
+* execute($parameters, $hydrationMode) the argument $parameters can be either an key=>value array or an ArrayCollection instance
+* iterate($parameters, $hydrationMode) the argument $parameters can be either an key=>value array or an ArrayCollection instance
+* setParameters($parameters) the argument $parameters can be either an key=>value array or an ArrayCollection instance
+* getParameters() now returns ArrayCollection instead of array
+* getParameter($key) now returns Parameter instance instead of parameter value
\ No newline at end of file