diff --git a/doc/api/stream.md b/doc/api/stream.md index c0a14c7aaa359f..6eb7de98ae88f2 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -1754,8 +1754,9 @@ methods only. The `writable._writev()` method may be implemented in addition to `writable._write()` in stream implementations that are capable of processing -multiple chunks of data at once. If implemented, the method will be called with -all chunks of data currently buffered in the write queue. +multiple chunks of data at once. If implemented, the first chunk will be written with +`_write()`. When the initial write is complete, buffered chunks in the write queue, if available, +will be written all at once with `_writev()`. The `writable._writev()` method is prefixed with an underscore because it is internal to the class that defines it, and should never be called directly by