From 08977822ee40b69e424b09bdb5f30fb3edbe23a8 Mon Sep 17 00:00:00 2001
From: Robert Nagy <ronagy@icloud.com>
Date: Tue, 23 Jul 2019 07:21:49 +0200
Subject: [PATCH] doc: writableFinished is true before 'finish'

PR-URL: https://github.com/nodejs/node/pull/28811
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
---
 doc/api/http.md   | 5 ++++-
 doc/api/stream.md | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/api/http.md b/doc/api/http.md
index fefdd7fdb04..5deb50ed8fd 100644
--- a/doc/api/http.md
+++ b/doc/api/http.md
@@ -1480,7 +1480,9 @@ added: v12.7.0
 
 * {boolean}
 
-Is `true` if all data has been flushed to the underlying system.
+Is `true` if all data has been flushed to the underlying system, immediately
+before the [`'finish'`][] event is emitted.
+
 
 ### response.writeContinue()
 <!-- YAML
@@ -2198,6 +2200,7 @@ not abort the request or do anything besides add a `'timeout'` event.
 [`agent.createConnection()`]: #http_agent_createconnection_options_callback
 [`agent.getName()`]: #http_agent_getname_options
 [`destroy()`]: #http_agent_destroy
+[`'finish'`]: #http_event_finish
 [`getHeader(name)`]: #http_request_getheader_name
 [`http.Agent`]: #http_class_http_agent
 [`http.ClientRequest`]: #http_class_http_clientrequest
diff --git a/doc/api/stream.md b/doc/api/stream.md
index 0053ed81fee..c7b00f983d8 100644
--- a/doc/api/stream.md
+++ b/doc/api/stream.md
@@ -496,7 +496,7 @@ added: v12.6.0
 
 * {boolean}
 
-Is `true` if after the [`'finish'`][] event has been emitted.
+Is set to `true` immediately before the [`'finish'`][] event is emitted.
 
 ##### writable.writableHighWaterMark
 <!-- YAML