diff --git a/json/mod.ts b/json/mod.ts
index 57dc9869febd..f9ceb26beb9c 100644
--- a/json/mod.ts
+++ b/json/mod.ts
@@ -1,7 +1,10 @@
 // Copyright 2018-2026 the Deno authors. MIT license.
 
 /**
- * Utilities for parsing streaming JSON data.
+ * Utilities for parsing streaming JSON data (newline-delimited
+ * JSON Lines / NDJSON, or concatenated JSON). Each chunk must
+ * be a complete JSON value. Not suited for streaming elements
+ * within a single large array.
  *
  * ```ts
  * import { JsonStringifyStream } from "@std/json";