diff --git a/doc/api/stream.md b/doc/api/stream.md index 4b6db64aae..7987eb8265 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -739,7 +739,8 @@ end ``` *Note*: In general, the `readable.pipe()` and `'data'` event mechanisms are -preferred over the use of the `'readable'` event. +easier to understand than the `'readable'` event. +However, handling `'readable'` might result in increased throughput. ##### readable.isPaused()