diff --git a/docs/api/async-logger-pending-count.md b/docs/api/async-logger-pending-count.md
index 170dd6a..a3e9a47 100644
--- a/docs/api/async-logger-pending-count.md
+++ b/docs/api/async-logger-pending-count.md
@@ -71,6 +71,9 @@ e.g.:
 
 - If `wait_idle()` returns early because `has_failed()` became `true`, `pending_count()` may still be above `0` until later cleanup or clear-close handling runs.
 - In the current tested split, that later cleanup can either force the leftover pending item into `dropped_count()` on native-worker shutdown paths or leave the closed-queue remainder visible in `pending_count()` on compatibility shutdown paths.
+- That means `pending_count()` can still stay above `0` even after `is_closed=true` on compatibility-style shutdown paths, because closure there does not necessarily convert the leftover failed backlog into dropped records.
+
+- A later restarted `run()` can still drain that retained backlog after failure-reset startup, so a nonzero pending count after failure is not necessarily a permanent terminal state.
 
 - If the queue is empty, the method simply returns `0`.