diff --git a/doc/api/stream.md b/doc/api/stream.md
index df171b95369741..e4bb2fc379c2db 100644
--- a/doc/api/stream.md
+++ b/doc/api/stream.md
@@ -799,6 +799,14 @@ to push an invalid chunk of data.
 
 The listener callback will be passed a single `Error` object.
 
+##### Event: 'pause'
+<!-- YAML
+added: v0.9.4
+-->
+
+The `'pause'` event is emitted when [`stream.pause()`][stream-pause] is called
+and `readableFlowing` is not `false`.
+
 ##### Event: 'readable'
 <!-- YAML
 added: v0.9.4
@@ -868,6 +876,14 @@ If there are `'data'` listeners when `'readable'` is removed, the stream
 will start flowing, i.e. `'data'` events will be emitted without calling
 `.resume()`.
 
+##### Event: 'resume'
+<!-- YAML
+added: v0.9.4
+-->
+
+The `'resume'` event is emitted when [`stream.resume()`][stream-resume] is
+called and `readableFlowing` is not `true`.
+
 ##### readable.destroy([error])
 <!-- YAML
 added: v8.0.0