Improve docs for order by on through preloads, closes #4330

elixir-ecto · Nov 30, 2023 · 4bd63cc · 4bd63cc
1 parent f870489
commit 4bd63cc
Showing 1 changed file with 7 additions and 3 deletions.
diff --git a/lib/ecto/query.ex b/lib/ecto/query.ex
@@ -2597,9 +2597,13 @@ defmodule Ecto.Query do
 
       Repo.all from p in Post, preload: [comments: ^comments_query]
 
-  Similarly, if you have a `:through` association, such as posts has many authors
-  through comments (`posts->comments->authors`), the query will only customize the
-  relationship between comments and authors, even if preloaded through posts.
+  Similarly, if you have a `:through` association, such as posts has many
+  `comments_authors` through comments (`posts->comments->comments_authors`),
+  the query will only customize the relationship between comments and
+  comments_authors, even if preloaded through posts. This means `order_by`
+  clauses on `:through` associations affect only the direct relationship
+  between `comments` and `comments_authors`, not between `posts` and
+  `comments_authors`.
 
   ## Preload functions