From 55cf80bfe2fa33f2b1f9f118b18abc60786b4f23 Mon Sep 17 00:00:00 2001
From: Dexter Leng <dexterlengcs@gmail.com>
Date: Sun, 28 Oct 2018 11:55:22 +0800
Subject: [PATCH 1/4] doc: add readable and writable property to Readable and
 Writable

---
 doc/api/stream.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/api/stream.md b/doc/api/stream.md
index fb2f2da28d1a87..f17b578f29a1c8 100644
--- a/doc/api/stream.md
+++ b/doc/api/stream.md
@@ -463,6 +463,16 @@ process.nextTick(() => {
 
 See also: [`writable.cork()`][].
 
+##### writable.writable
+<!-- YAML
+added: REPLACEME
+-->
+
+* {boolean}
+
+A boolean that is `true` by default, but turns `false` after the 
+[`stream.end()`][stream-end] method has been called.
+
 ##### writable.writableHighWaterMark
 <!-- YAML
 added: v9.3.0
@@ -1013,6 +1023,15 @@ also be emitted.
 Calling [`stream.read([size])`][stream-read] after the [`'end'`][] event has
 been emitted will return `null`. No runtime error will be raised.
 
+##### readable.readable
+<!-- YAML
+added: REPLACEME
+-->
+
+* {boolean}
+
+A boolean that is `true` by default, but turns `false` immediately before the `'end'` event is emitted.
+
 ##### readable.readableHighWaterMark
 <!-- YAML
 added: v9.3.0

From db1b5b23cb0a2791160fadc323ec6b923e9c76c3 Mon Sep 17 00:00:00 2001
From: Dexter Leng <dexterlengcs@gmail.com>
Date: Sun, 28 Oct 2018 12:04:38 +0800
Subject: [PATCH 2/4] doc: remove returns from Readable properties

---
 doc/api/stream.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/api/stream.md b/doc/api/stream.md
index f17b578f29a1c8..73fe1a9ffc8a7c 100644
--- a/doc/api/stream.md
+++ b/doc/api/stream.md
@@ -1037,7 +1037,7 @@ A boolean that is `true` by default, but turns `false` immediately before the `'
 added: v9.3.0
 -->
 
-* Returns: {number}
+* {number}
 
 Returns the value of `highWaterMark` passed when constructing this
 `Readable`.
@@ -1047,7 +1047,7 @@ Returns the value of `highWaterMark` passed when constructing this
 added: v9.4.0
 -->
 
-* Returns: {number}
+* {number}
 
 This property contains the number of bytes (or objects) in the queue
 ready to be read. The value provides introspection data regarding

From 8c4ccca54a5db8cb6fcf94a2d8fa1c2c0fd614d9 Mon Sep 17 00:00:00 2001
From: James M Snell <jasnell@gmail.com>
Date: Mon, 29 Oct 2018 23:07:47 +0800
Subject: [PATCH 3/4] doc: address comment

Co-Authored-By: dexterleng <34204380+dexterleng@users.noreply.github.com>
---
 doc/api/stream.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/api/stream.md b/doc/api/stream.md
index 73fe1a9ffc8a7c..8824eb28cb9a03 100644
--- a/doc/api/stream.md
+++ b/doc/api/stream.md
@@ -1030,7 +1030,8 @@ added: REPLACEME
 
 * {boolean}
 
-A boolean that is `true` by default, but turns `false` immediately before the `'end'` event is emitted.
+A boolean that is `true` by default, but turns `false` immediately before
+the `'end'` event is emitted.
 
 ##### readable.readableHighWaterMark
 <!-- YAML

From 4fb9ffe6b36d975c7496ac74c318729d38ccc94d Mon Sep 17 00:00:00 2001
From: Rich Trott <rtrott@gmail.com>
Date: Wed, 21 Nov 2018 10:30:33 -0800
Subject: [PATCH 4/4] fixup! doc: address comment

---
 doc/api/stream.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/doc/api/stream.md b/doc/api/stream.md
index 8824eb28cb9a03..c44e216ec43aa9 100644
--- a/doc/api/stream.md
+++ b/doc/api/stream.md
@@ -470,8 +470,7 @@ added: REPLACEME
 
 * {boolean}
 
-A boolean that is `true` by default, but turns `false` after the 
-[`stream.end()`][stream-end] method has been called.
+Is `true` if it is safe to call [`writable.write()`][].
 
 ##### writable.writableHighWaterMark
 <!-- YAML
@@ -1030,8 +1029,7 @@ added: REPLACEME
 
 * {boolean}
 
-A boolean that is `true` by default, but turns `false` immediately before
-the `'end'` event is emitted.
+Is `true` if it is safe to call [`readable.read()`][].
 
 ##### readable.readableHighWaterMark
 <!-- YAML