diff options
author | Jon Moss <maclover7@users.noreply.github.com> | 2016-08-21 22:01:28 -0400 |
---|---|---|
committer | GitHub <noreply@github.com> | 2016-08-21 22:01:28 -0400 |
commit | 409dbc891d2d153f43263e0cafc214912e6b4e6c (patch) | |
tree | b6d002ae45f15d6cd721780c912c80ae66ab6d49 /guides | |
parent | 0f0349b7ee13015944f11bc34a907d2d4157dde4 (diff) | |
parent | f3626c38fce4bb2fe3478366abc5a17b9880bb37 (diff) | |
download | rails-409dbc891d2d153f43263e0cafc214912e6b4e6c.tar.gz rails-409dbc891d2d153f43263e0cafc214912e6b4e6c.tar.bz2 rails-409dbc891d2d153f43263e0cafc214912e6b4e6c.zip |
Merge pull request #26241 from scottyantipa/query-interface-docs
Upate guides to properly define return values of finder methods
Diffstat (limited to 'guides')
-rw-r--r-- | guides/source/active_record_querying.md | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/guides/source/active_record_querying.md b/guides/source/active_record_querying.md index 6f941d0e4e..0601c05e4b 100644 --- a/guides/source/active_record_querying.md +++ b/guides/source/active_record_querying.md @@ -84,7 +84,7 @@ The methods are: * `distinct` * `where` -All of the above methods return an instance of `ActiveRecord::Relation`. +Finder methods that return a collection, such as `where` and `group`, return an instance of `ActiveRecord::Relation`. Methods that find a single entity, such as `find` and `first`, return a single instance of the model. The primary operation of `Model.find(options)` can be summarized as: @@ -1251,9 +1251,9 @@ articles, all the articles would still be loaded. By using `joins` (an INNER JOIN), the join conditions **must** match, otherwise no records will be returned. -NOTE: If an association is eager loaded as part of a join, any fields from a custom select clause will not present be on the loaded models. +NOTE: If an association is eager loaded as part of a join, any fields from a custom select clause will not present be on the loaded models. This is because it is ambiguous whether they should appear on the parent record, or the child. - + Scopes ------ |