feat(learn/userland-migrations): add intro

[JakobJingleheimer]

Description

Validation

Related Issues

Resolves #7267

Check List

• I don't use pnpm

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
nodejs-org	✅ Ready (Inspect)	Visit Preview	May 23, 2025 11:00am

[Copilot]

Pull Request Overview

This PR adds a new introductory documentation page for Node.js userland migrations.

• Introduces a new markdown page with an overview of userland migrations.
• Provides code examples demonstrating how to run a migration and the resulting source modifications.

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 75.33%. Comparing base (232e7f1) to head (9cd0b7b).
Report is 9 commits behind head on main.

✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #7764      +/-   ##
==========================================
+ Coverage   75.10%   75.33%   +0.22%     
==========================================
  Files          98       96       -2     
  Lines        7914     7856      -58     
  Branches      196      192       -4     
==========================================
- Hits         5944     5918      -26     
+ Misses       1969     1937      -32     
  Partials        1        1              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[AugustinMauroy]

@JakobJingleheimer put this part of learn sestion under user land team in the codeowner

[JakobJingleheimer]

@JakobJingleheimer put this part of learn sestion under user land team in the codeowner

There does not appear to be a section in codeowners for that. Are you asking me to add one there?

https://github.com/nodejs/nodejs.org/blob/main/CODEOWNERS

[AugustinMauroy]

@JakobJingleheimer put this part of learn sestion under user land team in the codeowner

There does not appear to be a section in codeowners for that. Are you asking me to add one there?

https://github.com/nodejs/nodejs.org/blob/main/CODEOWNERS

yeah I mean ad the end of code owners we should add user land migration

[AugustinMauroy]

LGMT ! cc @bmuenzenmeyer for code owner

[avivkeller]

Note that adding @nodejs/userland-migrations to CODEOWNERS (and hence, giving them write access) will give write access to three users that would not otherwise have said access.

[JakobJingleheimer]

Note that adding @nodejs/userland-migrations to CODEOWNERS (and hence, giving them write access) will give write access to three users that would not otherwise have said access.

I would prefer for the change to be in a dedicated PR than appended to a quasi-related one. Especially if the change is controversial 🙂

[github-actions]

Lighthouse Results

URL	Performance	Accessibility	Best Practices	SEO	Report
/en	🟠 86	🟢 100	🟢 100	🟢 91	🔗
/en/about	🟢 100	🟢 100	🟢 100	🟠 82	🔗
/en/about/previous-releases	🟢 100	🟢 100	🟢 100	🟠 83	🔗
/en/download	🟢 97	🟢 100	🟢 96	🟢 91	🔗
/en/blog	🟢 100	🟢 100	🟢 96	🟢 92	🔗