From f4041ce1c9f35bc1ea9653d1331e65b0d216071c Mon Sep 17 00:00:00 2001
From: Livia Medeiros <livia@cirno.name>
Date: Mon, 25 Sep 2023 23:57:19 +0900
Subject: [PATCH] doc: deprecate `fs.F_OK`, `fs.R_OK`, `fs.W_OK`, `fs.X_OK`

PR-URL: https://github.com/nodejs/node/pull/49683
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
---
 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 aca38c89379437..c66511553d9825 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -3406,6 +3406,20 @@ Type: Documentation-only
 The [`util.toUSVString()`][] API is deprecated. Please use
 [`String.prototype.toWellFormed`][] instead.
 
+### DEP0175: `fs.F_OK`, `fs.R_OK`, `fs.W_OK`, `fs.X_OK`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/49683
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+`F_OK`, `R_OK`, `W_OK` and `X_OK` getters exposed directly on `node:fs` are
+deprecated. Get them from `fs.constants` or `fs.promises.constants` instead.
+
 [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 499711f5240af3..d223fa5fb7ca5f 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -1820,6 +1820,10 @@ concurrent modifications on the same file or data corruption may occur.
 <!-- YAML
 added: v0.11.15
 changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/49683
+    description: The constants `fs.F_OK`, `fs.R_OK`, `fs.W_OK` and `fs.X_OK`
+                 which were present directly on `fs` are deprecated.
   - version: v18.0.0
     pr-url: https://github.com/nodejs/node/pull/41678
     description: Passing an invalid callback to the `callback` argument