a.patch

diff --git a/doc/api/stream.markdown b/doc/api/stream.markdown
index a894591..7132a32 100644
--- a/doc/api/stream.markdown
+++ b/doc/api/stream.markdown
@@ -120,8 +120,10 @@ A `Writable Stream` has the following methods, members, and events.
 
 `function () { }`
 
-After a `write()` method returned `false`, this event is emitted to
-indicate that it is safe to write again.
+The `write()` method may return `false` indicating that node had to enqueue
+the data because the stream endpoint (e.g. network connection) couldn't keep
+up. When that happens, the `drain` event will be emitted when node's queue is
+empty again, and more data can safely be written.
 
 ### Event: 'error'