diff --git a/‎index.d.ts‎
Lines changed: 2 additions & 0 deletions b/‎index.d.ts‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎readme.md‎
Lines changed: 2 additions & 0 deletions b/‎readme.md‎
Lines changed: 2 additions & 0 deletions
@@ -111,6 +111,8 @@ export type Options = {
 
 	This has no effect on Windows as there's no good way to implement discarding stdin properly there.
 
+	Note: `discardStdin` puts stdin into raw mode. In raw mode, `Ctrl+C` no longer generates `SIGINT` from the terminal. Ora re-emits `Ctrl+C` from stdin input, but if your code blocks the event loop with synchronous work, `Ctrl+C` handling is delayed until the blocking work ends. Use async APIs, a worker thread, or a child process to keep `Ctrl+C` responsive, or set `discardStdin` to `false`.
+
 	@default true
 	*/
 	readonly discardStdin?: boolean;
 
@@ -138,6 +138,8 @@ Discard stdin input (except Ctrl+C) while running if it's TTY. This prevents the
 
 This has no effect on Windows as there is no good way to implement discarding stdin properly there.
 
+Note: `discardStdin` puts stdin into raw mode. In raw mode, `Ctrl+C` no longer generates `SIGINT` from the terminal. Ora re-emits `Ctrl+C` from stdin input, but if your code blocks the event loop with synchronous work, `Ctrl+C` handling is delayed until the blocking work ends. Use async APIs, a worker thread, or a child process to keep `Ctrl+C` responsive, or set `discardStdin` to `false`.
+
 ### Instance
 
 #### .text <sup>get/set</sup>