From e1a080835132b02b074ce05835210d4a71e1a663 Mon Sep 17 00:00:00 2001
From: Marco Ippolito <marcoippolito54@gmail.com>
Date: Tue, 5 Mar 2024 14:49:36 +0100
Subject: [PATCH] doc: deprecate fs.Stats public constructor

PR-URL: https://github.com/nodejs/node/pull/51879
Refs: https://github.com/nodejs/node/pull/51681
Reviewed-By: Yagiz Nizipli <yagiz.nizipli@sentry.io>
Reviewed-By: Paolo Insogna <paolo@cowtech.it>
---
 doc/api/deprecations.md | 14 ++++++++++++++
 doc/api/fs.md           |  4 ++++
 2 files changed, 18 insertions(+)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index ef54e200f814ad..10f9fe4d74a874 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -3574,6 +3574,20 @@ Calling `Hash` class directly with `Hash()` or `new Hash()` is
 deprecated due to being internals, not intended for public use.
 Please use the [`crypto.createHash()`][] method to create Hash instances.
 
+### DEP0180: `fs.Stats` constructor
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/51879
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+Calling `fs.Stats` class directly with `Stats()` or `new Stats()` is
+deprecated due to being internals, not intended for public use.
+
 [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
diff --git a/doc/api/fs.md b/doc/api/fs.md
index 252db1b392f7c0..94b2ab5c3d31da 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -6999,6 +6999,9 @@ i.e. before the `'ready'` event is emitted.
 <!-- YAML
 added: v0.1.21
 changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/51879
+    description: Public constructor is deprecated.
   - version: v8.1.0
     pr-url: https://github.com/nodejs/node/pull/13173
     description: Added times as numbers.
@@ -7011,6 +7014,7 @@ their synchronous counterparts are of this type.
 If `bigint` in the `options` passed to those methods is true, the numeric values
 will be `bigint` instead of `number`, and the object will contain additional
 nanosecond-precision properties suffixed with `Ns`.
+`Stat` objects are not to be created directly using the `new` keyword.
 
 ```console
 Stats {