diff --git a/doc/api/tty.md b/doc/api/tty.md
index f9be1fc4ffd3e5..8f250e45d655f9 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -50,6 +50,13 @@ raw device. Defaults to `false`.
 added: v0.7.7
 -->
 
+Allows configuration of `tty.ReadStream` so that it operates as a raw device.
+
+When in raw mode, input is always available character-by-character, not
+including modifiers. Additionally, all special processing of characters by the
+terminal is disabled, including echoing input characters.
+Note that `CTRL`+`C` will no longer cause a `SIGINT` when in this mode.
+
 * `mode` {boolean} If `true`, configures the `tty.ReadStream` to operate as a
   raw device. If `false`, configures the `tty.ReadStream` to operate in its
   default mode. The `readStream.isRaw` property will be set to the resulting