From bc82a84e0f4cb59282f0593a773fe0b76d82f9a8 Mon Sep 17 00:00:00 2001
From: Augustin Mauroy <97875033+AugustinMauroy@users.noreply.github.com>
Date: Sat, 22 Nov 2025 10:35:58 +0100
Subject: [PATCH] doc: add additional codemods for deprecation

---
 doc/api/buffer.md       | 12 ++++++++++++
 doc/api/deprecations.md | 24 ++++++++++++++++++++++++
 doc/api/globals.md      |  8 +++++++-
 doc/api/repl.md         |  6 ++++++
 doc/api/util.md         |  6 ++++++
 5 files changed, 55 insertions(+), 1 deletion(-)

diff --git a/doc/api/buffer.md b/doc/api/buffer.md
index 66b04675641a42..981c053ac40f0c 100644
--- a/doc/api/buffer.md
+++ b/doc/api/buffer.md
@@ -5189,6 +5189,12 @@ For code running using Node.js APIs, converting between base64-encoded strings
 and binary data should be performed using `Buffer.from(str, 'base64')` and
 `buf.toString('base64')`.**
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/buffer-atob-btoa):
+
+```bash
+npx codemod@latest @nodejs/buffer-atob-btoa
+```
+
 ### `buffer.btoa(data)`
 
 <!-- YAML
@@ -5213,6 +5219,12 @@ For code running using Node.js APIs, converting between base64-encoded strings
 and binary data should be performed using `Buffer.from(str, 'base64')` and
 `buf.toString('base64')`.**
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/buffer-atob-btoa):
+
+```bash
+npx codemod@latest @nodejs/buffer-atob-btoa
+```
+
 ### `buffer.isAscii(input)`
 
 <!-- YAML
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index 95a237326f7f49..2ce1c8b16e8564 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -1034,6 +1034,12 @@ Type: Runtime
 The [`util.isArray()`][] API is deprecated. Please use `Array.isArray()`
 instead.
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-is)):
+
+```bash
+npx codemod@latest @nodejs/util-is
+```
+
 ### DEP0045: `util.isBoolean()`
 
 <!-- YAML
@@ -2199,6 +2205,12 @@ Type: Runtime
 The [`crypto.fips`][] property is deprecated. Please use `crypto.setFips()`
 and `crypto.getFips()` instead.
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/crypto-fips-to-getFips)).
+
+```bash
+npx codemod@latest @nodejs/crypto-fips-to-getFips
+```
+
 ### DEP0094: Using `assert.fail()` with more than one argument
 
 <!-- YAML
@@ -2326,6 +2338,12 @@ Type: End-of-Life
 
 This was never a documented feature.
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/createCredentials-to-createSecureContext)).
+
+```bash
+npx codemod@latest @nodejs/createCredentials-to-createSecureContext
+```
+
 ### DEP0101: `--with-lttng`
 
 <!-- YAML
@@ -4049,6 +4067,12 @@ Instantiating classes without the `new` qualifier exported by the `node:repl` mo
 The `new` qualifier must be used instead. This applies to all REPL classes, including
 `REPLServer` and `Recoverable`.
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/repl-classes-with-new)):
+
+```bash
+npx codemod@latest @nodejs/repl-classes-with-new
+```
+
 <!-- md-lint skip-deprecation DEP0186 -->
 
 ### DEP0187: Passing invalid argument types to `fs.existsSync`
diff --git a/doc/api/globals.md b/doc/api/globals.md
index fee0236de5004c..e37d12389bf607 100644
--- a/doc/api/globals.md
+++ b/doc/api/globals.md
@@ -274,7 +274,7 @@ added: v16.0.0
 
 Global alias for [`buffer.atob()`][].
 
-An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-is)):
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/buffer-atob-btoa)):
 
 ```bash
 npx codemod@latest @nodejs/buffer-atob-btoa
@@ -298,6 +298,12 @@ added: v16.0.0
 
 Global alias for [`buffer.btoa()`][].
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/buffer-atob-btoa)):
+
+```bash
+npx codemod@latest @nodejs/buffer-atob-btoa
+```
+
 ## `clearImmediate(immediateObject)`
 
 <!-- YAML
diff --git a/doc/api/repl.md b/doc/api/repl.md
index c120bb25efff29..0ebd5ca4e6f465 100644
--- a/doc/api/repl.md
+++ b/doc/api/repl.md
@@ -698,6 +698,12 @@ deprecated:
 
 A list of the names of some Node.js modules, e.g., `'http'`.
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/repl-builtin-modules)):
+
+```bash
+npx codemod@latest @nodejs/repl-builtin-modules
+```
+
 ## `repl.start([options])`
 
 <!-- YAML
diff --git a/doc/api/util.md b/doc/api/util.md
index 4a2f9cb9ec56e4..cd06da633cf021 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -3797,6 +3797,12 @@ util.isArray({});
 // Returns: false
 ```
 
+An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-is)):
+
+```bash
+npx codemod@latest @nodejs/util-is
+```
+
 [Common System Errors]: errors.md#common-system-errors
 [Custom inspection functions on objects]: #custom-inspection-functions-on-objects
 [Custom promisified functions]: #custom-promisified-functions