From 64aa31f6e5440dc8d5efedd75486f56a12bca883 Mon Sep 17 00:00:00 2001
From: Aviv Keller <redyetidev@gmail.com>
Date: Mon, 9 Sep 2024 18:37:48 -0400
Subject: [PATCH] repl: doc-deprecate instantiating `node:repl` classes without
 `new`

PR-URL: https://github.com/nodejs/node/pull/54842
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: LiviaMedeiros <livia@cirno.name>
Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
---
 doc/api/deprecations.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index f45dae963921c8..cdb32c2b9dccc1 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -3558,6 +3558,21 @@ Instantiating classes without the `new` qualifier exported by the `node:zlib` mo
 It is recommended to use the `new` qualifier instead. This applies to all Zlib classes, such as `Deflate`,
 `DeflateRaw`, `Gunzip`, `Inflate`, `InflateRaw`, `Unzip`, and `Zlib`.
 
+### DEP0185: Instantiating `node:repl` classes without `new`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/54842
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+Instantiating classes without the `new` qualifier exported by the `node:repl` module is deprecated.
+It is recommended to use the `new` qualifier instead. This applies to all REPL classes, including
+`REPLServer` and `Recoverable`.
+
 [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
 [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
 [RFC 8247 Section 2.4]: https://www.rfc-editor.org/rfc/rfc8247#section-2.4