feat(learn/userland-migrations): add intro (#7764)

* feat(learn/userland-migrations): add intro

* fixup!: prettier

* fixup!: english → american

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Jacob Smith <3012099+JakobJingleheimer@users.noreply.github.com>

* fixup!: add nav & labels

* Update introduction.md

Co-authored-by: Aviv Keller <me@aviv.sh>
Signed-off-by: Jacob Smith <3012099+JakobJingleheimer@users.noreply.github.com>

* fixup!: clarify wording

* fixup!: remove CLI prompt from code block

Co-authored-by: Augustin Mauroy <97875033+AugustinMauroy@users.noreply.github.com>
Signed-off-by: Jacob Smith <3012099+JakobJingleheimer@users.noreply.github.com>

* fixup!: add `@nodejs/userland-migrations` to CODEOWNERS

* Revert "fixup!: add `@nodejs/userland-migrations` to CODEOWNERS"

This reverts commit 3655407.

---------

Signed-off-by: Jacob Smith <3012099+JakobJingleheimer@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Aviv Keller <me@aviv.sh>
Co-authored-by: Augustin Mauroy <97875033+AugustinMauroy@users.noreply.github.com>

Author: 4 people

apps/site/navigation.json

@@ -332,6 +332,15 @@
             }
           }
         },
+        "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": {

apps/site/pages/en/learn/migrations/introduction.md

@@ -0,0 +1,28 @@
+---
+title: Userland Migrations
+layout: learn
+authors: JakobJingleheimer
+---
+
+# Userland Migrations
+
+Node.js provides migrations for "userland" (what you write vs node's own) source-code to facilitate adoption of new features and upgrading source-code affected by breaking changes. These are done in collaboration with [`codemod`](https://www.codemod.com), who also work with other major projects like Next.js, React, and Tailwind. Node.js's migrations live in the [`nodejs/userland-migrations`](https://github.com/nodejs/userland-migrations) repository and are overseen by the [`@nodejs/userland-migrations`](https://github.com/orgs/nodejs/teams/userland-migrations) team.
+
+Official migrations are published under the `@nodejs` namespace within the [codemod registry](https://codemod.com/registry?framework=node.js). These have been reviewed and/or authored by Node.js members. There are also unofficial migrations available which have not been reviewed by Node.js.
+
+A migration alters a project's source-code to apply a new design pattern, like:
+
+```console
+cd path/to/your/project
+npx codemod@latest @nodejs/correct-ts-specifiers
+```
+
+The cited migration transforms legacy typescript imports to standards-compliant specifiers like:
+
+```ts displayName="before"
+import Foo from './foo';
+```
+
+```ts displayName="after"
+import type Foo from './foo/index.ts';
+```

packages/i18n/locales/en.json

@@ -94,6 +94,12 @@
             "acceptInputFromTheCommandLineInNodejs": "Accept input from the command line in Node.js"
           }
         },
+        "migrations": {
+          "links": {
+            "migrations": "Userland Migrations",
+            "introduction": "Introduction to Userland Migrations"
+          }
+        },
         "modules": {
           "links": {
             "modules": "Modules",