From a64f3738612e6569ee941b59c58709f4630e3b45 Mon Sep 17 00:00:00 2001
From: Yagiz Nizipli <yagiz@nizipli.com>
Date: Sun, 1 Sep 2024 19:42:25 -0400
Subject: [PATCH] zlib: deprecate instantiating classes without new

---
 doc/api/deprecations.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index d7a985d2edac67..d3cbc9eab6c1a0 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -3711,6 +3711,20 @@ switch to its new provider model. The `clientCertEngine` option for
 the `privateKeyEngine` and `privateKeyIdentifier` for [`tls.createSecureContext()`][];
 and [`crypto.setEngine()`][] all depend on this functionality from OpenSSL.
 
+### DEP0184: Zlib classes
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/54708
+    description: Documentation-only deprecation.
+
+Type: Documentation-only
+
+Instantiating classes without the `new` qualifier exported by the `node:zlib` module is deprecated.
+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`.
+
 [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