diff --git a/doc/api/readline.md b/doc/api/readline.md
index ef6957a89fc6fc..5e890c12852439 100644
--- a/doc/api/readline.md
+++ b/doc/api/readline.md
@@ -316,6 +316,9 @@ rl.on('line', (line) => {
 });
 ```
 
+*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