diff --git a/lib/membership/member.ex b/lib/membership/member.ex
index f57c32a5..9f7965bb 100644
--- a/lib/membership/member.ex
+++ b/lib/membership/member.ex
@@ -271,7 +271,10 @@ defmodule Mv.Membership.Member do
     # action only enables keyset pagination with a unique `id` tie-breaker so
     # pages never skip or duplicate rows.
     read :overview do
-      description "Keyset-paginated member overview read"
+      # Distinct from the plain `:read` (`list_members`), which returns the full
+      # unpaginated set: `:overview` (`overview_members`) is keyset-paginated and
+      # left intentionally bare so `OverviewQuery` composes filters/sort onto it.
+      description "Keyset-paginated, externally-composed member overview read"
       pagination keyset?: true, default_limit: 50, required?: false
     end
 
diff --git a/lib/membership/membership.ex b/lib/membership/membership.ex
index b7c5974d..d1295c6b 100644
--- a/lib/membership/membership.ex
+++ b/lib/membership/membership.ex
@@ -44,6 +44,8 @@ defmodule Mv.Membership do
   resources do
     resource Mv.Membership.Member do
       define :create_member, action: :create_member
+      # `list_members` returns the full unpaginated set; `overview_members` is the
+      # keyset-paginated base for the member overview (composed by OverviewQuery).
       define :list_members, action: :read
       define :overview_members, action: :overview
       define :update_member, action: :update_member