aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/association_basics.md
diff options
context:
space:
mode:
authorSean Collins <sean@cllns.com>2015-11-06 12:15:31 -0700
committerSean Collins <sean@cllns.com>2015-11-06 12:19:57 -0700
commit0aea9289f215d62d6b5e84557954c1136a6a1720 (patch)
tree5f6fd3ec626c5c8f37522fc162b8b376adf873c5 /guides/source/association_basics.md
parentcb67c819338d75c07a591dc23759747c740a5088 (diff)
downloadrails-0aea9289f215d62d6b5e84557954c1136a6a1720.tar.gz
rails-0aea9289f215d62d6b5e84557954c1136a6a1720.tar.bz2
rails-0aea9289f215d62d6b5e84557954c1136a6a1720.zip
Clarify automatic creation/deletion of join models for has_many through
[ci-skip]
Diffstat (limited to 'guides/source/association_basics.md')
-rw-r--r--guides/source/association_basics.md6
1 files changed, 4 insertions, 2 deletions
diff --git a/guides/source/association_basics.md b/guides/source/association_basics.md
index 996050d667..c272daac28 100644
--- a/guides/source/association_basics.md
+++ b/guides/source/association_basics.md
@@ -240,13 +240,15 @@ class CreateAppointments < ActiveRecord::Migration
end
```
-The collection of join models can be managed via the API. For example, if you assign
+The collection of join models can be managed via the [`has_many` association methods](#has-many-association-reference).
+For example, if you assign:
```ruby
physician.patients = patients
```
-new join models are created for newly associated objects, and if some are gone their rows are deleted.
+Then new join models are automatically created for the newly associated objects.
+If some that existed previously are now missing, then their join rows are automatically deleted.
WARNING: Automatic deletion of join models is direct, no destroy callbacks are triggered.