diff --git a/doc/api/tty.md b/doc/api/tty.md
index bd73327aabad5b..1234526dd588dd 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -51,7 +51,11 @@ added: v0.7.7
 -->
 
 A `boolean` that is `true` if the TTY is currently configured to operate as a
-raw device. Defaults to `false`.
+raw device.
+
+This flag is always `false` when a process starts, even if the terminal is
+operating in raw mode. Its value will change with subsequent calls to
+`setRawMode`.
 
 ### `readStream.isTTY`