diff --git a/docs/error-handling.md b/docs/error-handling.md
index 251eb82..c746801 100644
--- a/docs/error-handling.md
+++ b/docs/error-handling.md
@@ -326,7 +326,9 @@ error trace:
 
 Traces are on by default in debug builds and compiled out in release
 (re-enable with `--release-traces`). They cost nothing on the success
-path. Frame locations resolve through the binary's debug info, so
+path. Each frame's location comes from `Frame` metadata
+(file/line/col/func) baked in at the trace point — the trace resolves
+itself with no debug info. Separately, sx emits standard DWARF, so
 `lldb` / `gdb` work on sx binaries too.
 
 Interpolating a tag with `{}` prints its **name**, not a number — in