docs(web/guides): note shortcut name accepted in findAll include for many-to-many

github-actions[bot] · github-actions[bot] · commit 15f9949606b0 · 2026-06-15T00:01:07.000Z
Signed-off-by: claude[bot] &lt;41898282+claude[bot]@users.noreply.github.com&gt;
diff --git a/web/sites/guides/src/content/docs/v4-0-0/basics/associations.mdx b/web/sites/guides/src/content/docs/v4-0-0/basics/associations.mdx
@@ -239,7 +239,7 @@ component extends="Model" {
 }
 ```
 
-A single `hasMany` with `shortcut` provides both access paths: `user.userRoles()` for the join rows and `user.roles()` for the far-side records. Behind the scenes Wheels walks both association chains to build the query. The same declaration also works correctly with `include` — `model("User").findAll(include="userRoles")` joins the join table as expected.
+A single `hasMany` with `shortcut` provides both access paths: `user.userRoles()` for the join rows and `user.roles()` for the far-side records. Behind the scenes Wheels walks both association chains to build the query. Both names also work in `include`: `model("User").findAll(include="userRoles")` loads just the join rows, and `model("User").findAll(include="roles")` uses the shortcut name to load the far-side records through the bridge in one step (Wheels expands it to `userRoles(role)` automatically).
 
 The join model needs both `belongsTo` declarations:
 

Original file line number	Diff line number	Diff line change
`@@ -239,7 +239,7 @@ component extends="Model" {`
`239`	`239`	`}`
`240`	`240`	```
`241`	`241`
`242`		-A single `hasMany` with `shortcut` provides both access paths: `user.userRoles()` for the join rows and `user.roles()` for the far-side records. Behind the scenes Wheels walks both association chains to build the query. The same declaration also works correctly with `include` — `model("User").findAll(include="userRoles")` joins the join table as expected.
	`242`	+A single `hasMany` with `shortcut` provides both access paths: `user.userRoles()` for the join rows and `user.roles()` for the far-side records. Behind the scenes Wheels walks both association chains to build the query. Both names also work in `include`: `model("User").findAll(include="userRoles")` loads just the join rows, and `model("User").findAll(include="roles")` uses the shortcut name to load the far-side records through the bridge in one step (Wheels expands it to `userRoles(role)` automatically).
`243`	`243`
`244`	`244`	The join model needs both `belongsTo` declarations:
`245`	`245`