diff --git a/contracts/gitea-api.md b/contracts/gitea-api.md
index 9b87ed0..c537242 100644
--- a/contracts/gitea-api.md
+++ b/contracts/gitea-api.md
@@ -572,7 +572,7 @@ GitHub errors return JSON with `message` and optionally `errors`:
 ## Pagination
 
 Gitea list endpoints return paginated results. The migration scripts do NOT
-paginate because the data volumes are small (3 repos, ~3 runners, ~3 mirrors).
+paginate because the data volumes are typically small (a handful of repos, runners, and mirrors).
 
 ### Gitea Pagination Headers
 
@@ -593,6 +593,6 @@ link: <url?page=2&limit=50>; rel="next", <url?page=5&limit=50>; rel="last"
 ### When Pagination Would Matter
 
 If any of these grow beyond 50 items, scripts that use these endpoints would
-silently miss results. For this migration (3 repos, handful of runners), this
-is not a concern. If extending to N repos where N > 50, add `?limit=N` or
+silently miss results. For typical migrations (under 50 repos/runners), this
+is not a concern. If migrating more than 50 repos, add `?limit=N` or
 implement `Link` header following.