diff --git a/src/dpy_logger/dpy_logger.py b/src/dpy_logger/dpy_logger.py
index be32230..40ba683 100644
--- a/src/dpy_logger/dpy_logger.py
+++ b/src/dpy_logger/dpy_logger.py
@@ -41,9 +41,10 @@ extending: this base has no feed/announcement method by design. a project
 that wants one subclasses DPYLogger and adds it, reusing _resolve.
 
 errors: resolution failures (unresolvable guild/channel, bad config) raise
-ValueError at initialize/call time — a misconfigured logger should fail loudly.
-per-call send failures do NOT propagate: they fall back to the stdlib logger so
-a transient discord failure never breaks the caller's command.
+ValueError from `initialize()` — a misconfigured logger should fail loudly at
+setup. on a per-call send, resolution AND send failures do NOT propagate: they
+fall back to the stdlib logger so a transient discord failure (or a per-call
+`guild=` that doesn't resolve) never breaks the caller's command.
 """
 
 import logging