From ff73ac98d4bf481010b1a4003c40ed6f6a33e6b6 Mon Sep 17 00:00:00 2001
From: Khafra <maitken033380023@gmail.com>
Date: Mon, 25 Sep 2023 18:36:35 -0400
Subject: [PATCH] Revert "doc: promote fetch/webstreams from experimental to
 stable"

This reverts commit 740ca5423aabc06af48f6dacfb17335bbaa25c0c1.

At minimum, this needs more discussion.

Refs: https://github.com/nodejs/undici/issues/1737#issuecomment-1729783598
---
 doc/api/cli.md        |  2 +-
 doc/api/globals.md    | 36 +++++++++++-------------------------
 doc/api/webstreams.md |  6 +-----
 3 files changed, 13 insertions(+), 31 deletions(-)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index 1da38c1739126b..3f94a1dc0a8b2f 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -1117,7 +1117,7 @@ Silence deprecation warnings.
 added: v18.0.0
 -->
 
-Disable exposition of [Fetch API][] on the global scope.
+Disable experimental support for the [Fetch API][].
 
 ### `--no-experimental-global-customevent`
 
diff --git a/doc/api/globals.md b/doc/api/globals.md
index 7cc6b3d02454eb..9e2e1d0761a8d1 100644
--- a/doc/api/globals.md
+++ b/doc/api/globals.md
@@ -478,16 +478,13 @@ added:
   - v17.5.0
   - v16.15.0
 changes:
-  - version:
-    - REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/45684
-    description: No longer experimental.
   - version: v18.0.0
     pr-url: https://github.com/nodejs/node/pull/41811
     description: No longer behind `--experimental-global-fetch` CLI flag.
 -->
 
-> Stability: 2 - Stable
+> Stability: 1 - Experimental. Disable this API with the [`--no-experimental-fetch`][]
+> CLI flag.
 
 A browser-compatible implementation of the [`fetch()`][] function.
 
@@ -508,16 +505,13 @@ added:
   - v17.6.0
   - v16.15.0
 changes:
-  - version:
-    - REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/45684
-    description: No longer experimental.
   - version: v18.0.0
     pr-url: https://github.com/nodejs/node/pull/41811
     description: No longer behind `--experimental-global-fetch` CLI flag.
 -->
 
-> Stability: 2 - Stable
+> Stability: 1 - Experimental. Disable this API with the [`--no-experimental-fetch`][]
+> CLI flag.
 
 A browser-compatible implementation of {FormData}.
 
@@ -547,16 +541,13 @@ added:
   - v17.5.0
   - v16.15.0
 changes:
-  - version:
-    - REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/45684
-    description: No longer experimental.
   - version: v18.0.0
     pr-url: https://github.com/nodejs/node/pull/41811
     description: No longer behind `--experimental-global-fetch` CLI flag.
 -->
 
-> Stability: 2 - Stable
+> Stability: 1 - Experimental. Disable this API with the [`--no-experimental-fetch`][]
+> CLI flag.
 
 A browser-compatible implementation of {Headers}.
 
@@ -822,16 +813,13 @@ added:
   - v17.5.0
   - v16.15.0
 changes:
-  - version:
-    - REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/45684
-    description: No longer experimental.
   - version: v18.0.0
     pr-url: https://github.com/nodejs/node/pull/41811
     description: No longer behind `--experimental-global-fetch` CLI flag.
 -->
 
-> Stability: 2 - Stable
+> Stability: 1 - Experimental. Disable this API with the [`--no-experimental-fetch`][]
+> CLI flag.
 
 A browser-compatible implementation of {Response}.
 
@@ -842,16 +830,13 @@ added:
   - v17.5.0
   - v16.15.0
 changes:
-  - version:
-    - REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/45684
-    description: No longer experimental.
   - version: v18.0.0
     pr-url: https://github.com/nodejs/node/pull/41811
     description: No longer behind `--experimental-global-fetch` CLI flag.
 -->
 
-> Stability: 2 - Stable
+> Stability: 1 - Experimental. Disable this API with the [`--no-experimental-fetch`][]
+> CLI flag.
 
 A browser-compatible implementation of {Request}.
 
@@ -1052,6 +1037,7 @@ A browser-compatible implementation of [`WritableStreamDefaultWriter`][].
 [ECMAScript module]: esm.md
 [Navigator API]: https://html.spec.whatwg.org/multipage/system-state.html#the-navigator-object
 [Web Crypto API]: webcrypto.md
+[`--no-experimental-fetch`]: cli.md#--no-experimental-fetch
 [`--no-experimental-global-customevent`]: cli.md#--no-experimental-global-customevent
 [`--no-experimental-global-webcrypto`]: cli.md#--no-experimental-global-webcrypto
 [`AbortController`]: https://developer.mozilla.org/en-US/docs/Web/API/AbortController
diff --git a/doc/api/webstreams.md b/doc/api/webstreams.md
index 6d75212aba4a3f..a8a111caef6414 100644
--- a/doc/api/webstreams.md
+++ b/doc/api/webstreams.md
@@ -5,16 +5,12 @@
 <!-- YAML
 added: v16.5.0
 changes:
-  - version:
-    - REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/45684
-    description: No longer experimental.
   - version: v18.0.0
     pr-url: https://github.com/nodejs/node/pull/42225
     description: Use of this API no longer emit a runtime warning.
 -->
 
-> Stability: 2 - Stable
+> Stability: 1 - Experimental.
 
 An implementation of the [WHATWG Streams Standard][].