Add text to debug doc about multiple invocations (#5225)

brimdata · Aug 16, 2024 · 60e2601 · 60e2601
1 parent f7ddbc4
commit 60e2601
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/language/operators/debug.md b/docs/language/operators/debug.md
@@ -17,6 +17,10 @@ channel is displayed on stderr.
 The `debug` operator is useful to view intermediate values when debugging a
 complex Zed query.
 
+If used more than once within a single Zed program, the relative order of
+outputs in the debug channel from each separate `debug` invocation is
+undefined.
+
 ### Examples
 
 The following query uses expressions containing [f-strings](../expressions.md#formatted-string-literals)