Hi,

I'm not sure where to post this, but if someone could please make this very 
simple change. Maybe it will help someone else in the future.

I just spent a lot of time debugging Cake to try and understand what 
Model::associations() does. The phpDoc says 'Get associations' which sounds 
like it would return an array of all the associations for a model. 
Basically the same thing as Model::getAssociated().

I'd like the phpDoc to be more clear. Maybe read something like

"Gets an array all the association types support by this model."

It's not clear that the array return is NOT the actual associations of the 
models. You can see $this->_associations constantly used in the Model so it 
can be temping to this this is where those things are stored. The reason I 
was confused and didn't use getAssociated() is that the descriptions reads.

"Gets all the models with which this model is associated."

That implies that it returns the Model objects. The description should read.

"Gets the name of all the models with this model is associated."

I'd just like those docs to be less ambiguous. 

-- 
Like Us on FaceBook https://www.facebook.com/CakePHP
Find us on Twitter http://twitter.com/CakePHP

--- 
You received this message because you are subscribed to the Google Groups 
"CakePHP" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to cake-php+unsubscr...@googlegroups.com.
To post to this group, send email to cake-php@googlegroups.com.
Visit this group at http://groups.google.com/group/cake-php?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to