diff --git a/doc/api/stream.md b/doc/api/stream.md index 3836056d81c..ca37243c90e 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -768,7 +768,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()