From 28b0de8081814780fe3e80b7ec4d423ba70cdc9a Mon Sep 17 00:00:00 2001
From: James M Snell <jasnell@gmail.com>
Date: Tue, 27 Apr 2021 08:02:39 -0700
Subject: [PATCH] doc: mark querystring api as legacy

Signed-off-by: James M Snell <jasnell@gmail.com>
Fixes: https://github.com/nodejs/node/issues/38231
---
 doc/api/querystring.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/api/querystring.md b/doc/api/querystring.md
index 2b8755df413914..4b7db7afc3b948 100644
--- a/doc/api/querystring.md
+++ b/doc/api/querystring.md
@@ -2,7 +2,7 @@
 
 <!--introduced_in=v0.1.25-->
 
-> Stability: 2 - Stable
+> Stability: 3 - Legacy
 
 <!--name=querystring-->
 
@@ -15,6 +15,9 @@ query strings. It can be accessed using:
 const querystring = require('querystring');
 ```
 
+The `querystring` API is considered Legacy. While it is still maintained,
+new code should use the {URLSearchParams} API instead.
+
 ## `querystring.decode()`
 <!-- YAML
 added: v0.1.99