diff --git a/doc/api/readline.md b/doc/api/readline.md
index c01397d57108b6..2ffe08a31bc943 100644
--- a/doc/api/readline.md
+++ b/doc/api/readline.md
@@ -315,6 +315,9 @@ rl.write('Delete this!');
 rl.write(null, {ctrl: true, name: 'u'});
 ```
 
+*Note*: The `rl.write()` method will write the data to the `readline`
+Interface's `input` *as if it were provided by the user*.
+
 ## readline.clearLine(stream, dir)
 <!-- YAML
 added: v0.7.7