Merge pull request cakephp#5881 from dreamingmind/patch-1

Update retrieving-data-and-resultsets.rst

Author: markstory

en/orm/retrieving-data-and-resultsets.rst

@@ -399,6 +399,14 @@ If you need to modify the results after they have been fetched you should use
 a :ref:`map-reduce` function to modify the results. The map reduce features
 replace the 'afterFind' callback found in previous versions of CakePHP.
 
+.. note::
+
+    Passing arguments exposed in the **config** array, 
+    ``$products->find('sizes', ['large', 'medium'])`` 
+    can give unexpected results when chaining 
+    custom finders. Always pass options as an associative array, 
+    ``$products->find('sizes', ['values' => ['large', 'medium']])``
+
 .. _dynamic-finders:
 
 Dynamic Finders