docs(stackoverflow): clarify read fetches answers up to --answers-limit (not 'all')

Follow-up from PR #1293 review: 'all answers' was misleading because the implementation is limit-bounded (default 10, max 100) rather than unbounded pagination. Spell out the actual contract — including the accepted-answer-outside-page fallback path — so users don't expect infinite-scroll behaviour. Non-blocking docs-only change flagged by codex-mini1 + First-principles-1 during #1293 review.
2026-05-04 19:18:13 +08:00
1 changed files with 5 additions and 2 deletions
@@ -34,8 +34,11 @@

 ## `read` columns

-`stackoverflow read <id>` fetches the question, all answers (accepted first,
-then by votes), question comments, and answer comments. It mirrors the
+`stackoverflow read <id>` fetches the question, answers up to
+`--answers-limit` (accepted first, then by votes — if the accepted
+answer is outside the votes-sorted page it is fetched separately and
+prepended), question comments up to `--comments-limit`, and answer
+comments up to `--comments-limit` per answer. It mirrors the
 `hackernews read` and `lobsters read` thread shape.

 | Column | Description |