From 842bc64833d30b73c33fc9c1e39f5a527ec6a4b5 Mon Sep 17 00:00:00 2001
From: Rich Trott <rtrott@gmail.com>
Date: Sun, 9 Oct 2022 08:22:50 -0700
Subject: [PATCH] doc: remove Legacy status from querystring
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Closes: https://github.com/nodejs/node/issues/44911
PR-URL: https://github.com/nodejs/node/pull/44912
Fixes: https://github.com/nodejs/node/issues/44911
Reviewed-By: Erick Wendel <erick.workspace@gmail.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
---
 doc/api/querystring.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/api/querystring.md b/doc/api/querystring.md
index a3db3c13a80a3d..752d4b9d584242 100644
--- a/doc/api/querystring.md
+++ b/doc/api/querystring.md
@@ -2,7 +2,7 @@
 
 <!--introduced_in=v0.1.25-->
 
-> Stability: 3 - Legacy
+> Stability: 2 - Stable
 
 <!--name=querystring-->
 
@@ -15,8 +15,9 @@ query strings. It can be accessed using:
 const querystring = require('node:querystring');
 ```
 
-The `querystring` API is considered Legacy. While it is still maintained,
-new code should use the {URLSearchParams} API instead.
+`querystring` is more performant than {URLSearchParams} but is not a
+standardized API. Use {URLSearchParams} when performance is not critical or
+when compatibility with browser code is desirable.
 
 ## `querystring.decode()`