content(userland-migration): make up to date

apps/site/layouts/Blog.tsx

@@ -63,6 +63,7 @@ const BlogLayout: FC = () => {
               'announcements',
               'release',
               'vulnerability',
+              'migrations',
               'events',
             ])}
           />

apps/site/mdx/components.mjs

@@ -1,5 +1,6 @@
 'use strict';
 
+import AlertBox from '@node-core/ui-components/Common/AlertBox';
 import BadgeGroup from '@node-core/ui-components/Common/BadgeGroup';
 import Blockquote from '@node-core/ui-components/Common/Blockquote';
 import MDXCodeTabs from '@node-core/ui-components/MDX/CodeTabs';
@@ -54,6 +55,8 @@ export default {
   blockquote: Blockquote,
   pre: MDXCodeBox,
   img: MDXImage,
+  // Renders a CSS-enhanced Alert Box
+  AlertBox,
   // Renders MDX CodeTabs
   CodeTabs: MDXCodeTabs,
   // Renders Tooltips

apps/site/navigation.json

@@ -205,6 +205,10 @@
             "securityBestPractices": {
               "link": "/learn/getting-started/security-best-practices",
               "label": "components.navigation.learn.gettingStarted.links.securityBestPractices"
+            },
+            "userlandMigrations": {
+              "link": "/learn/getting-started/userland-migrations",
+              "label": "components.navigation.learn.gettingStarted.links.userlandMigrations"
             }
           }
         },
@@ -336,15 +340,6 @@
             }
           }
         },
-        "migrations": {
-          "label": "components.navigation.learn.migrations.links.migrations",
-          "items": {
-            "introduction": {
-              "link": "/learn/migrations/introduction",
-              "label": "components.navigation.learn.migrations.links.introduction"
-            }
-          }
-        },
         "modules": {
           "label": "components.navigation.learn.modules.links.modules",
           "items": {
@@ -419,6 +414,31 @@
               "label": "components.navigation.learn.testRunner.links.collectingCodeCoverage"
             }
           }
+        },
+        "userland-migrations": {
+          "label": "components.navigation.learn.userland-migrations.links.userland-migrations",
+          "items": {
+            "introduction": {
+              "link": "/learn/userland-migrations/introduction",
+              "label": "components.navigation.learn.userland-migrations.links.introduction"
+            },
+            "ecosystem": {
+              "link": "/learn/userland-migrations/ecosystem",
+              "label": "components.navigation.learn.userland-migrations.links.ecosystem"
+            },
+            "v22-to-v24": {
+              "link": "/learn/userland-migrations/v22-to-v24",
+              "label": "components.navigation.learn.userland-migrations.links.v22-to-v24"
+            },
+            "v20-to-v22": {
+              "link": "/learn/userland-migrations/v20-to-v22",
+              "label": "components.navigation.learn.userland-migrations.links.v20-to-v22"
+            },
+            "v14-to-v16": {
+              "link": "/learn/userland-migrations/v14-to-v16",
+              "label": "components.navigation.learn.userland-migrations.links.v14-to-v16"
+            }
+          }
         }
       }
     }

apps/site/next.mdx.use.mjs

@@ -0,0 +1,43 @@
+'use strict';
+
+import BadgeGroup from '@node-core/ui-components/Common/BadgeGroup';
+
+import Button from './components/Common/Button';
+import LinkWithArrow from './components/Common/LinkWithArrow';
+import EOLAlertBox from './components/EOL/EOLAlert';
+import EOLReleaseTable from './components/EOL/EOLReleaseTable';
+import Link from './components/Link';
+import UpcomingMeetings from './components/MDX/Calendar/UpcomingMeetings';
+import PreviousReleasesTable from './components/Releases/PreviousReleasesTable';
+import WithBadgeGroup from './components/withBadgeGroup';
+import WithBanner from './components/withBanner';
+import WithNodeRelease from './components/withNodeRelease';
+
+/**
+ * A full list of React Components that we want to pass through to MDX
+ *
+ * @satisfies {import('mdx/types').MDXComponents}
+ */
+export const mdxComponents = {
+  PreviousReleasesTable,
+  // HOC for getting Node.js Release Metadata
+  WithNodeRelease,
+  // HOC for providing Banner Data
+  WithBanner,
+  // HOC for providing Badge Data
+  WithBadgeGroup,
+  // Standalone Badge Group
+  BadgeGroup,
+  // Renders an container for Upcoming Node.js Meetings
+  UpcomingMeetings,
+  // Renders an EOL alert
+  EOLAlertBox,
+  // Renders the EOL Table
+  EOLReleaseTable,
+  // Renders a Button Component for `button` tags
+  Button,
+  // Regular links (without arrow)
+  Link,
+  // Links with External Arrow
+  LinkWithArrow,
+};

apps/site/pages/en/blog/migrations/v12-to-v14.mdx

@@ -0,0 +1,56 @@
+---
+date: '2025-10-10T12:00:00.000Z'
+category: migrations
+title: Node.js v12 to v14
+layout: blog-post
+author: AugustinMauroy
+---
+
+# Node.js v12 to v14
+
+<AlertBox level="warning" title="!">
+  This article cover a part of the migration from Node.js v12 to v14. The
+  userland migrations team is working on more codemods to help you with the
+  migration.
+</AlertBox>
+
+This page provides a list of codemods to help you migrate your code from Node.js v12 to v14.
+
+## `util-print-to-console-log`
+
+This recipe transforms calls of various now-deprecated `node:util` log functions into the modern alternative, `console.log` and `console.error`:
+
+- [DEP0026](https://nodejs.org/api/deprecations.html#DEP0026): `util.print` ➜ `console.log`
+- [DEP0027](https://nodejs.org/api/deprecations.html#DEP0027): `util.puts` ➜ `console.log`
+- [DEP0028](https://nodejs.org/api/deprecations.html#DEP0028): `util.debug` ➜ `console.error`
+- [DEP0029](https://nodejs.org/api/deprecations.html#DEP0029): `util.error` ➜ `console.error`
+
+```bash
+npx codemod run @nodejs/create-require-from-path
+```
+
+### Example:
+
+```js displayName="Before"
+const util = require('node:util');
+
+util.print('Hello world');
+util.puts('Hello world');
+util.debug('Hello world');
+util.error('Hello world');
+```
+
+```js displayName="After"
+console.log('Hello world');
+console.log('Hello world');
+console.error('Hello world');
+console.error('Hello world');
+```
+
+### Source Code
+
+The source code for this codemod can be found in the [util-print-to-console-log directory](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-print-to-console-log).
+
+### Registry Link
+
+You can find this codemod in the [Codemod Registry](https://app.codemod.com/registry/@nodejs/util-print-to-console-log).

apps/site/pages/en/blog/migrations/v14-to-v16.mdx

@@ -0,0 +1,181 @@
+---
+date: '2025-10-10T12:00:00.000Z'
+category: migrations
+title: Node.js v14 to v16
+layout: blog-post
+author: AugustinMauroy
+---
+
+# Node.js v14 to v16
+
+<AlertBox level="warning" title="!">
+  This article cover a part of the migration from Node.js v14 to v16. The
+  userland migrations team is working on more codemods to help you with the
+  migration.
+</AlertBox>
+
+This page provides a list of codemods to help you migrate your code from Node.js v14 to v16.
+
+## `create-require-from-path`
+
+Node.js v16 replaced the [`createRequireFromPath`](https://nodejs.org/api/module.html#module_module_createrequirefrompath) function, deprecated in [DEP0148](https://nodejs.org/api/deprecations.html#DEP0148), with the modern [`createRequire`](https://nodejs.org/api/module.html#module_module_createrequire) function. This codemod replaces calls of the deprecated function with the modern alternative mentioned.
+
+```bash
+npx codemod run @nodejs/create-require-from-path
+```
+
+### Example:
+
+```js displayName="Before"
+import { createRequireFromPath } from 'node:module';
+
+const requireFromPath = createRequireFromPath('/path/to/module');
+const myModule = requireFromPath('./myModule.cjs');
+```
+
+```js displayName="After"
+import { createRequire } from 'node:module';
+
+const require = createRequire('/path/to/module');
+const myModule = require('./myModule.cjs');
+```
+
+### Source Code
+
+The source code for this codemod can be found in the [create-require-from-path directory](https://github.com/nodejs/userland-migrations/tree/main/recipes/create-require-from-path).
+
+### Registry Link
+
+You can find this codemod in the [Codemod Registry](https://app.codemod.com/registry/@nodejs/create-require-from-path).
+
+## `process-main-module`
+
+The `process.mainModule` property was deprecated in favor of `require.main`. This codemod will help you replace the old `process.mainModule` usage with the new `require.main` usage.
+
+So the codemod handle [DEP0138](https://nodejs.org/api/deprecations.html#DEP0138).
+
+```bash
+npx codemod run @nodejs/process-main-module
+```
+
+### Example:
+
+```js displayName="Before"
+if (process.mainModule === 'mod.js') {
+  // cli thing
+} else {
+  // module thing
+}
+```
+
+```js displayName="After"
+if (require.main === 'mod.js') {
+  // cli thing
+} else {
+  // module thing
+}
+```
+
+### Source Code
+
+The source code for this codemod can be found in the [process-main-module directory](https://github.com/nodejs/userland-migrations/tree/main/recipes/process-main-module).
+
+### Registry Link
+
+You can find this codemod in the [Codemod Registry](https://app.codemod.com/registry/@nodejs/process-main-module).
+
+## `process-mainModule-to-require-main`
+
+The [`process.mainModule`](https://nodejs.org/api/process.html#process_process_mainmodule) property was deprecated ([DEP0144](https://nodejs.org/api/deprecations.html#DEP0144)) in favor of [`require.main`](https://nodejs.org/api/modules.html#modules_accessing_the_main_module). This codemod replaces calls of the deprecated property with the modern alternative mentioned.
+
+```bash
+npx codemod run @nodejs/process-mainModule-to-require-main
+```
+
+### Example:
+
+```js displayName="Before"
+if (process.mainModule) {
+  console.log('This script is the main module');
+}
+```
+
+```js displayName="After"
+if (require.main === module) {
+  console.log('This script is the main module');
+}
+```
+
+## `rmdir`
+
+The `fs.rmdir` function was deprecated in favor of `fs.rm` with the `{ recursive: true }` option. This codemod will help you replace the old `fs.rmdir` function with the new `fs.rm` function.
+
+so this codemod handle [DEP0147](https://nodejs.org/api/deprecations.html#DEP0147).
+
+```bash
+npx codemod run @nodejs/rmdir
+```
+
+### Example:
+
+```js displayName="Before"
+// Using fs.rmdir with the recursive option
+fs.rmdir(path, { recursive: true }, callback);
+
+// Using fs.rmdirSync with the recursive option
+fs.rmdirSync(path, { recursive: true });
+
+// Using fs.promises.rmdir with the recursive option
+fs.promises.rmdir(path, { recursive: true });
+```
+
+```js displayName="After"
+// Using fs.rm with recursive and force options
+fs.rm(path, { recursive: true, force: true }, callback);
+
+// Using fs.rmSync with recursive and force options
+fs.rmSync(path, { recursive: true, force: true });
+
+// Using fs.promises.rm with recursive and force options
+fs.promises.rm(path, { recursive: true, force: true });
+```
+
+### Source Code
+
+The source code for this codemod can be found in the [rmdir directory](https://github.com/nodejs/userland-migrations/tree/main/recipes/rmdir).
+
+### Registry Link
+
+You can find this codemod in the [Codemod Registry](https://app.codemod.com/registry/@nodejs/rmdir).
+
+## `tmpDir-to-tmpdir`
+
+The `tmpDir` function was renamed to `tmpdir` in Node.js v16. This codemod will help you replace all instances of `tmpDir` with `tmpdir`.
+
+So the codemod handles [DEP0022](https://nodejs.org/docs/latest/api/deprecations.html#dep0022-ostmpdir).
+
+```bash
+npx codemod run @nodejs/tmpDir-to-tmpdir
+```
+
+### Example:
+
+```js displayName="Before"
+import { tmpDir } from 'node:os';
+
+const foo = tmpDir();
+```
+
+```js displayName="After"
+import { tmpdir } from 'node:os';
+
+const foo = tmpdir();
+```
+
+### Source Code
+
+The source code for this codemod can be found in the [tmpdir-to-tmpdir directory](https://github.com/nodejs/userland-migrations/tree/main/recipes/tmpdir-to-tmpdir).
+
+### Registry Link
+
+You can find this codemod in the [Codemod Registry](https://app.codemod.com/registry/@nodejs/tmpDir-to-tmpdir).