aboutsummaryrefslogtreecommitdiffstats
path: root/guides
diff options
context:
space:
mode:
authorJon Moss <maclover7@users.noreply.github.com>2016-08-21 22:01:28 -0400
committerGitHub <noreply@github.com>2016-08-21 22:01:28 -0400
commit409dbc891d2d153f43263e0cafc214912e6b4e6c (patch)
treeb6d002ae45f15d6cd721780c912c80ae66ab6d49 /guides
parent0f0349b7ee13015944f11bc34a907d2d4157dde4 (diff)
parentf3626c38fce4bb2fe3478366abc5a17b9880bb37 (diff)
downloadrails-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.md6
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
------